Environment variables

The authoritative source is modules/commons/commons-config/src/main/java/org/eclipse/dirigible/commons/config/DirigibleConfig.java (the enum) plus Configuration.java (the allow-list). The list below covers the variables you typically set during install.

The full reference (every variable, every default) is at /help/reference/environment-variables.

Server

Variable	Default	Purpose
DIRIGIBLE_SERVER_PORT	8080	HTTP listen port.
DIRIGIBLE_HOME_URL	services/web/shell-ide/	Where / redirects to.
DIRIGIBLE_BASIC_USERNAME	admin	Default basic-auth user.
DIRIGIBLE_BASIC_PASSWORD	admin	Default basic-auth password.
DIRIGIBLE_SECURITY_LOGIN_PAGE	-	Application-owned login page for the OAuth2 profiles; unauthenticated browsers are redirected there instead of the identity provider. See First-Party Sign-In.

Repository

Variable	Default	Purpose
DIRIGIBLE_REPOSITORY_LOCAL_ROOT_FOLDER	./target/	On-disk registry root.
DIRIGIBLE_REGISTRY_EXTERNAL_FOLDER		Mount an external folder into the registry.
DIRIGIBLE_REGISTRY_EXTERNAL_FOLDER_AS_SUBFOLDER		Mount under a sub-path.
DIRIGIBLE_REGISTRY_EXTERNAL_FOLDER_IGNORED_FOLDERS		Comma-separated ignore list.

Data sources

Variable	Default	Purpose
DIRIGIBLE_DATASOURCE_DEFAULT_DRIVER	H2 file driver	JDBC driver class.
DIRIGIBLE_DATASOURCE_DEFAULT_URL	local H2	JDBC URL.
DIRIGIBLE_DATASOURCE_DEFAULT_USERNAME		JDBC user.
DIRIGIBLE_DATASOURCE_DEFAULT_PASSWORD		JDBC password.
DIRIGIBLE_DATABASE_DATASOURCE_NAME_DEFAULT	DefaultDB	Logical name.
DIRIGIBLE_DATABASE_DATASOURCE_NAME_SYSTEM	SystemDB	Logical name of the system DB.
DIRIGIBLE_LEAKED_CONNECTIONS_CHECK_INTERVAL_SECONDS		JDBC leak detection cadence.
DIRIGIBLE_LEAKED_CONNECTIONS_CHECK_MAX_IN_USE_SECONDS		Threshold before logging a leak.

Multi-tenancy

Variable	Default	Purpose
DIRIGIBLE_MULTI_TENANT_MODE	true	Multi-tenant switch.
DIRIGIBLE_TENANT_RESOLUTION_STRATEGY	SUBDOMAIN	How a request's tenant is determined: SUBDOMAIN (a host per tenant) or TOKEN_GROUPS (one host, the tenant the signed-in user selected).
DIRIGIBLE_TENANT_SUBDOMAIN_REGEX		Host pattern the tenant subdomain is captured from, under the SUBDOMAIN strategy.
DIRIGIBLE_APP_ID		This deployment's application id in the group names <tenantId>.<appId>.<role>. Required under TOKEN_GROUPS, and it must not contain a dot.
DIRIGIBLE_TENANT_GROUPS_CLAIM	cognito:groups	The token claim the user's groups are read from. Set it explicitly on Keycloak.
DIRIGIBLE_TENANTS_PROVISIONING_FREQUENCY_SECONDS	900	Provisioning poll cadence, in seconds.
DIRIGIBLE_TENANT_PROVISIONING_API_ENABLED	false	Exposes the tenant provisioning API, through which an external service provisions tenants into this deployment. Off means absent, not closed.

See Tenant resolution and Tenant provisioning API.

Debuggers

Variable	Default	Purpose
DIRIGIBLE_JAVASCRIPT_GRAALVM_DEBUGGER_PORT	8081	Graalium JS debugger port.
DIRIGIBLE_GRAALIUM_ENABLE_DEBUG	true (in Docker)	Toggle JS debug.
DIRIGIBLE_JAVA_DEBUG_JDWP_PORT	8000	JDWP port for the Java debugger view.
DIRIGIBLE_JAVA_LSP_ENABLED		Toggle JDT.LS.
DIRIGIBLE_JAVA_LSP_INSTALL_DIR		JDT.LS install directory.

Synchronizers

Variable	Default	Purpose
DIRIGIBLE_SYNCHRONIZER_FREQUENCY		Reconciliation cadence.
DIRIGIBLE_SYNCHRONIZER_CROSS_RETRY_COUNT		Retry budget for cross-synchronizer dependencies.
DIRIGIBLE_SYNCHRONIZER_CROSS_RETRY_INTERVAL_MILLIS		Retry interval.

Messaging

Variable	Default	Purpose
DIRIGIBLE_MESSAGING_BROKER_URL		External ActiveMQ broker to use instead of the embedded one, e.g. tcp://activemq:61616. Unset keeps the embedded broker.
DIRIGIBLE_MESSAGING_BROKER_USERNAME		Broker username. Unset connects anonymously.
DIRIGIBLE_MESSAGING_BROKER_PASSWORD		Broker password.
DIRIGIBLE_MESSAGING_USE_DEFAULT_DATABASE	true	Persist the embedded broker's messages in the system database. Ignored with an external broker.

Point several nodes or deployments at one broker to share destinations between them. The broker has to be reachable when the server starts, and the Messaging perspective works only against the embedded broker. See Message listeners.

Mail / Flowable / SharePoint / S3

Variable	Purpose
DIRIGIBLE_MAIL_*	SMTP defaults for the Mail SDK.
DIRIGIBLE_FLOWABLE_*	Flowable engine config (datasource, mail).
DIRIGIBLE_MS_SHAREPOINT_*	SharePoint CMS credentials.
DIRIGIBLE_CMS_INTERNAL_ROOT_FOLDER	Internal CMIS root path.
DIRIGIBLE_S3_PROVIDER	aws or localstack.

OAuth (GitHub profile)

Variable	Purpose
DIRIGIBLE_GITHUB_CLIENT_ID	GitHub OAuth client id.
DIRIGIBLE_GITHUB_CLIENT_SECRET	GitHub OAuth client secret.
DIRIGIBLE_GITHUB_SCOPE	Requested scopes.

Activated only when the github Spring profile is active. See /help/setup/authentication/github-oauth.

Misc

Variable	Purpose
DIRIGIBLE_EXEC_COMMAND_LOGGING_ENABLED	Audit shell-exec calls.
DIRIGIBLE_TRIAL_ENABLED	Trial-mode flag.

See also

• Full env-var reference
• DirigibleConfig.java in the platform repo - source of truth.