Runtime configuration

SoloDB selects a tenant profile with two environment variables:

SOLODB_HOST selects config/<host> and the corresponding Docker Compose profile.
SOLODB_ENVIRONMENT selects the runtime mode, normally development, staging, or production.

Configuration is merged in this order: files in config/autoload, followed by files in config/<host>. A host-local setting therefore overrides a global default. Check both locations when tracing a value.

Host-specific CLI wrappers under bin/<host>/run set the variables before forwarding to Laminas CLI. In containers, use the wrapper for the same host as the Compose file, for example:

docker compose -f docker-compose.onelab.yml run --rm cli \
  /var/www/bin/onelab/run doctrine-module orm:validate-schema

The usual supporting services are the web server, worker, database, Redis, and Solr. Start or test against the intended host profile; changing only global configuration can leave tenant overrides inconsistent.

19 July 2026