v3.40.0

We are happy to announce release v3.40.0 of Elimity Insights, released on 29 April 2025.

Summary

This section summarizes the most important changes in release v3.40.0.

New functionality

• NTFS built-in connector

• Custom mail server support

Bug fixes & improvements

• Invite multiple users via comma-separated list of email addresses

• Minor bug fixes & improvements

Deployment changes

• Support for container-based deployments

• New configuration option for custom mail server support

• New mail server configuration options

New functionality

NTFS built-in connector

Elimity Insights v3.40.0 includes support for NTFS in its built-in connector library. This new connector imports trustees, access rights and files from your NTFS file systems. Refer to our dedicated documentation for more details.

Custom mail server support

The v3.40.0 release also adds support for admins to configure a custom mail server. If the SupportCustomMailServer system configuration option is enabled, then Elimity Insights will show an additional tab on the new advanced settings page:

This feature allows admins to override the system-configured mail server, which is mainly useful for our SaaS customers.

Bug fixes & improvements

Invite multiple users via comma-separated list of email addresses

The v3.40.0 release includes a slight redesign of the user account invitation UI. Instead of manually adding email addresses one-by-one to invite multiple users, admins can now enter all email addresses in one comma-separated line.

Minor bug fixes & improvements

As always, this new release brings some smaller bug fixes and improvements:

• The Google Workspace built-in connector includes a 'type' attribute for group roles.

• The SharePoint built-in connector can now also speed up site listing using multiple workers.

• The Vercel built-in connector includes a 'type' attribute for project roles and team roles.

• Date picker components in the UI now use a European instead of American locale.

Deployment changes

Support for container-based deployments

From v3.40.0 onwards we provide Docker images for both the Elimity Insights server and the database migration script. We highly recommend container-based deployments for all on-prem deployments, but existing customers can keep using plain executables as usual. Refer to our documentation about installing Elimity Insights servers for more details.

New configuration option for custom mail server support

Elimity Insights now allows enabling custom mail server support by setting the SupportCustomMailServer configuration option to true in elimity.yml:

# SupportCustomMailServer
# ----------------------------
#
# Data type: boolean
#
# Status: Optional
#
# Default value: false
#
# Description: determines whether admins can configure a custom mail server

New mail server configuration options

This release adds a few new system configuration options in secrets.yml related to Elimity Insights' connection with a mail server:

# SMTPEnableAuth
# ----------------------------
#
# Data type: boolean
#
# Status: Optional
#
# Default value: true
#
# Description: determines whether Elimity Insights should authenticate to the configured SMTP server

# SMTPEnableOAuth2
# ----------------------------
#
# Data type: boolean
#
# Status: Optional
#
# Default value: false
#
# Description: determines whether Elimity Insights should use OAuth2 for authentication to the configured SMTP server

# SMTPOAuth2ClientId
# ----------------------------
#
# Data type: string
#
# Status: Required if `SMTPEnableAuth` and `SMTPEnableOAuth2` are enabled
#
# Description: the client ID for OAuth2 authentication to the configured SMTP server

# SMTPOAuth2ClientSecret
# ----------------------------
#
# Data type: string
#
# Status: Required if `SMTPEnableAuth` and `SMTPEnableOAuth2` are enabled
#
# Description: the client secret for OAuth2 authentication to the configured SMTP server

# SMTPOAuth2Scope
# ----------------------------
#
# Data type: string
#
# Status: Required if `SMTPEnableAuth` and `SMTPEnableOAuth2` are enabled
#
# Description: the scope for OAuth2 authentication to the configured SMTP server

# SMTPOAuth2TokenUrl
# ----------------------------
#
# Data type: string
#
# Status: Required if `SMTPEnableAuth` and `SMTPEnableOAuth2` are enabled
#
# Description: the token URL for OAuth2 authentication to the configured SMTP server

For most customers the existing configuration should remain working as expected. However, customers that explicitly opt out of SMTP authentication by omitting the SMTPUser configuration option must now set EnableSMTPAuth to false.

Migration information

To migrate from v3.39.x to v3.40.0, we suggest the following steps:

1. Make a backup of your existing database.

2. Make a backup of your existing installation directory.

3. Migrate your installation by installing the files for v3.40.0, as described below.

4. Migrate your database, as described below.

5. Start the server and validate that it works as before.

Installing the files for v3.40.0

Customers that set up a container-based installation of Elimity Insights can simply bump the server image version. If you're using plain executables, copy the following files from the v3.40.0 release to your current installation folder:

• The appropriate binary of Elimity Insights for your OS:

  • elimity-insights-linux-x86_64

  • elimity-insights-macos-x86_64

  • elimity-insights-windows-x86_64.exe

• The appropriate binary of the database migration tool for your OS:

  • elimity-insights-database-migrate-macos-x86_64

  • elimity-insights-database-migrate-linux-x86_64

  • elimity-insights-database-migrate-windows-x86_64.exe

Migrating the database

Customers that set up a container-based installation of Elimity Insights should refer to our dedicated installation documentation for detailed upgrade instructions. If you're using plain executables, the database migration is performed by running one of the following executables depending on your OS:

• elimity-insights-database-migrate-macos-x86_64

• elimity-insights-database-migrate-linux-x86_64

• elimity-insights-database-migrate-windows-x86_64.exe

You can use the command line argument help to get help info:

$ ./elimity-insights-database-migrate-macos-x86_64 help

You can use the command line argument target-versions to display the list of supported target versions:

$ ./elimity-insights-database-migrate-macos-x86_64 target-versions

To migrate your database, use a command similar to the following:

$ ./elimity-insights-database-migrate-macos-x86_64 migrate -dsn 'postgresql://<postgres-user>:<postgres-password>@<your-host>:5432/<your-elimity-db-name>' -target-version 'v3.40'