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

Summary

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

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 the dedicated knowledge base article 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 bugfixes and improvements

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

• The Google Workspace connector includes a 'type' attribute for group roles.
• The SharePoint connector can now also speed up site listing using multiple workers.
• The Vercel 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 knowledge base article about installing and upgrading Elimity Insights for additional information.

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 knowledge base article about installing and upgrading Elimity Insights for detailed upgrade instructions. If you're using plain executables, the database migration is performed by running one of the following files 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'