Configuration

RustaSea reads typed configuration from TOML files in config/. The loader (rustasea_config::ConfigLoader) auto-discovers every config/*.toml:

1. app.toml is always applied first, as the base layer.
2. Remaining files are merged in sorted order.
3. The process environment is applied last — environment variables always win over files.

.env files are supported via dotenvy.

Environment overrides

Nested keys use the __ separator. SERVICES__POSTMARK__KEY sets [services.postmark].key.

Laravel-style single-underscore vars are applied by typed consumers where wired:

Config files

Key environment variables include APP_NAME, APP_ENV, APP_DEBUG, APP_URL, APP_KEY, APP_LOCALE, DATABASE_URL, DB_*, REDIS_*, QUEUE_CONNECTION, SESSION_*, MAIL_*, and BROADCAST_CONNECTION.

Database connections

rustasea-orm owns config-driven named connections, resolved lazily by ConnectionResolver. Both a legacy flat database.url and explicit [database.connections.<name>] tables are supported.

[database]
default = "pgsql"          # connection used when no name is given

[database.connections.sqlite]
driver = "sqlite"
url = "sqlite://database.sqlite?mode=rwc"

[database.connections.pgsql]
driver = "postgres"
host = "127.0.0.1"
port = 5432
database = "rustasea"
username = "rustasea"
password = "secret"

• Default switching — [database].default names the connection used by resolve(None); an explicit name overrides it.
• Read/write split — add an optional [database.connections.<name>.read] (and/or .write) overlay to route reads to a replica. Omitted fields inherit the primary.
• MongoDB — a connection with driver = "mongodb" resolves to a DatabaseConnection::Mongo handle behind the opt-in mongodb feature; without it, the connection resolves to a typed ConnectionError::UnsupportedDriver rather than panicking.

[database.connections.mongo]
driver = "mongodb"
uri = "mongodb://127.0.0.1:27017"
database = "rustasea"