> For the complete documentation index, see [llms.txt](https://docs.elimity.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.elimity.com/release-notes/v3.40.0.md).

# 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.

<details>

<summary>New functionality</summary>

* NTFS built-in connector
* Custom mail server support

</details>

<details>

<summary>Bug fixes &#x26; improvements</summary>

* Invite multiple users via comma-separated list of email addresses
* Minor bug fixes & improvements

</details>

<details>

<summary>Deployment changes</summary>

* Support for container-based deployments
* New configuration option for custom mail server support
* New mail server configuration options

</details>

## New functionality <a href="#h_01h9mxgpqsnkh8tpyx32gwcbsr" id="h_01h9mxgpqsnkh8tpyx32gwcbsr"></a>

### NTFS built-in connector <a href="#h_01h9mxgpqs7sd6b0ewt9frpxbs" id="h_01h9mxgpqs7sd6b0ewt9frpxbs"></a>

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](/reference-manual/built-in-connectors/ntfs.md) for more details.

### Custom mail server support <a href="#h_01jd4xyrcvsv9f34bfjghqg98w" id="h_01jd4xyrcvsv9f34bfjghqg98w"></a>

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:

<figure><img src="https://2067057569-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F7b6iwtH0Lr9Z5pj9MCO2%2Fuploads%2FzuqdaQVjbYhEupov4RAX%2Fimage.png?alt=media&amp;token=f5780887-d74e-4e8d-a593-ad36b1a4324c" alt=""><figcaption></figcaption></figure>

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 <a href="#h_01jqbxbjm9znha3yj0t3gv2p9f" id="h_01jqbxbjm9znha3yj0t3gv2p9f"></a>

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 <a href="#h_01js1h4hg2ekpaqj0a5kpn1hc0" id="h_01js1h4hg2ekpaqj0a5kpn1hc0"></a>

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

* [The Google Workspace built-in connector](/reference-manual/built-in-connectors/google-workspace.md) includes a 'type' attribute for group roles.
* [The SharePoint built-in connector](/reference-manual/built-in-connectors/sharepoint.md) can now also speed up site listing using multiple workers.
* [The Vercel built-in connector](/reference-manual/built-in-connectors/vercel.md) 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 <a href="#h_01js1h5k9app499gtxrx38e4cm" id="h_01js1h5k9app499gtxrx38e4cm"></a>

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](/reference-manual/installation/elimity-insights-server.md) for more details.

### New configuration option for custom mail server support <a href="#h_01js1h5wv9pzcd46np330rr08t" id="h_01js1h5wv9pzcd46np330rr08t"></a>

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

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

### New mail server configuration options <a href="#h_01js1h65t1xmcesf4p8g8trtfp" id="h_01js1h65t1xmcesf4p8g8trtfp"></a>

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

```yaml
# 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 <a href="#h_01h9mxgpqs599yv2hb64zhwdk9" id="h_01h9mxgpqs599yv2hb64zhwdk9"></a>

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 <a href="#h_01h9mxgpqsdj7y3gp98dbbb8hy" id="h_01h9mxgpqsdj7y3gp98dbbb8hy"></a>

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 <a href="#h_01jbc65m99c2bwscx5jmhccxey" id="h_01jbc65m99c2bwscx5jmhccxey"></a>

Customers that set up a container-based installation of Elimity Insights should refer to [our dedicated installation documentation](/reference-manual/installation/elimity-insights-server.md#upgrades) 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:

```shell-session
$ ./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:

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

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

```shell-session
$ ./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'
```


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter, and the optional `goal` query parameter:

```
GET https://docs.elimity.com/release-notes/v3.40.0.md?ask=<question>&goal=<endgoal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is optional and describes the broader end goal you are ultimately trying to accomplish on behalf of the user. GitBook uses it to tailor the answer towards what is most useful for that goal.

The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.