/
Trillium R1 2026 Modules deployment changes

Trillium R1 2026 Modules deployment changes

Module

Instructions

Comments

Contact person

Module

Instructions

Comments

Contact person

folio-spring-support
All modules based on this library

New environment variables are provided for database configuration:

  • DB_QUERYTIMEOUT

  • DB_CHARSET (Default: UTF-8)

  • DB_MAXSHAREDPOOLSIZE

  • DB_MINSHAREDPOOLSIZE (Default: 0)

  • DB_CONNECTIONRELEASEDELAY (Default: 60000 ms)

  • DB_MAX_LIFETIME (Default: 180000 ms)

Before Trillium, all modules could use and provide environment variables like DB_MAXPOOLSIZE for configuration, allowing connection pool settings to vary by module. Since the Trillium release, specified connection settings apply universally, with default values overriding all other environment or command-line variables

@Pavel Filippov

https://folio-org.atlassian.net/browse/FOLSPRINGS-217

mod-notes

Set NOTES_TYPES_DEFAULTS_LIMIT environment variable if the default 25 doesn’t suit your needs.

Before Trillium this was configured per tenant in mod-configuration (module==NOTES, configName==note-type-limit); it can no longer be configured per tenant but must be configured per deployed mod-notes module.

@Pavlo Smahin

https://folio-org.atlassian.net/browse/MODNOTES-274

mod-search

If using Elasticsearch: Add a new environment variable ELASTICSEARCH_SERVER with a value of true.

If using Opensearch: Don’t use the ELASTICSEARCH_SERVER environment variable, or set it to false (the default).

See Trillium R1 2026 Required manual migrations for the Opensearch upgrade from 2 to 3.

The mod-search module has been migrated to the new Opensearch 3.0.0 version. The Elasticsearch does not support the new HttpRequest parameter cluster_manager_timeout that was added in the new Opensearch version.
The new environment variable is used to replace the cluster_manager_timeout parameter with the master_timeout parameter in HttpRequest.

 

@Pavlo Smahin @Svitlana Kovalova

 

https://folio-org.atlassian.net/browse/MSEARCH-1042

mod-marc-migrations

Updated the default values of the following environment variables:

  • S3_URL --> string(default value https://s3.amazonaws.com)

  • S3_REGION --> string(default us-west-2)

  • S3_BUCKET --> string(default value null)

  • S3_ACCESS_KEY_ID --> string(default value null)

  • S3_SECRET_ACCESS_KEY --> string(default value null)

Added 2 env vars for subpath configuration:

  • S3_SUB_PATH --> S3 subpath for files storage --> string(default value “mod-marc-migrations“)

  • S3_LOCAL_SUB_PATH --> S3 subpath for local files storage --> string(default value “mod-marc-migrations“)

 

@Pavlo Smahin @Svitlana Kovalova

mod-inventory-storage

Updated the default values of the following environment variables:

  • S3_URL --> string(default value https://s3.amazonaws.com)

  • S3_REGION --> string(default us-west-2)

  • S3_BUCKET --> string(default value null)

  • S3_ACCESS_KEY_ID --> string(default value null)

  • S3_SECRET_ACCESS_KEY --> string(default value null)

Added env variable for subpath configuration:

  • S3_LOCAL_SUB_PATH --> S3 subpath for local files storage --> string(default value “mod-inventory-storage“)

 

@Pavlo Smahin @Svitlana Kovalova

mod-entities-links

Updated the default values of the following environment variables:

  • S3_URL --> string(default value https://s3.amazonaws.com )

  • S3_REGION --> string(default us-west-2)

  • S3_BUCKET --> string(default value null)

  • S3_ACCESS_KEY_ID --> string(default value null)

  • S3_SECRET_ACCESS_KEY --> string(default value null)

Added env variable for subpath configuration:

  • S3_LOCAL_SUB_PATH --> S3 subpath for local files storage --> string(default value “mod-entities-links“)

 

@Pavlo Smahin @Svitlana Kovalova

mod-circulation

If the environment variable ENABLE_FOR_USE_AT_LOCATION is set to TRUE the environment supports special workflow for loans only For use at location - also known as reading room loans.

Description: Allow single tenant installation to be configured to support For use at location functionality (Reading room loans).

The default setting is ENABLE_FOR_USE_AT_LOCATION = FALSE

@Charlotte Whitt @Niels Erik Nielsen

https://folio-org.atlassian.net/browse/CIRC-2457

mod-circulation

Connection to KAFKA_HOST and KAFKA_PORT must be possible at module startup.

Module no longer ignores an invalid Kafka configuration on startup.

@Julian Ladisch

https://folio-org.atlassian.net/browse/CIRC-2003

mod-entities-links / mod-inventory

Move AUTHORITY_EXTENDED env var from mod-inventory to mod-entities-links deployment configuration.

Details are covered in Authority DI Events Migration: mod-inventory → mod-entities-links

@Pavlo Smahin

mod-quick-marc

Restriction to have only one instance of the module is outdated. It could be deployed with more then 1 instance.

The module supports HA now.

@Pavlo Smahin