Configuration Reference¶

Docker users

Most of these are pre-configured in compose.yml. You only need to override values that differ from the defaults.

Application¶

Variable	Default	Description
`APP_NAME`	`Technic Solder`	Application name shown in the UI
`APP_ENV`	`production`	Environment (`production`, `local`)
`APP_KEY`	(generated)	Encryption key -- generated by `php artisan key:generate`
`APP_DEBUG`	`false`	Enable debug mode (never in production)
`APP_URL`	`http://localhost`	Full URL where Solder is accessible
`APP_TIMEZONE`	`UTC`	Application timezone
`HASH_VERIFY`	`false`	Must be `false` -- some legacy password hashes use $2a$ prefix

Variable	Default	Description
`DB_CONNECTION`	`mysql`	Database driver (`mysql`, `mariadb`, or `pgsql`)
`DB_HOST`	`127.0.0.1`	Database host (use `mysql` in Docker)
`DB_PORT`	`3306`	Database port
`DB_DATABASE`	`laravel`	Database name
`DB_USERNAME`	`root`	Database user
`DB_PASSWORD`	(empty)	Database password

Variable	Default	Description
`CACHE_STORE`	`file`	Cache driver (`file`, `redis`). Docker uses `redis`.
`SESSION_DRIVER`	`file`	Session driver. Docker uses `redis`.
`SESSION_LIFETIME`	`120`	Session lifetime in minutes
`SESSION_ENCRYPT`	`true`	Encrypt session data
`REDIS_HOST`	`127.0.0.1`	Redis/Valkey host (use `redis` in Docker)
`REDIS_PASSWORD`	(null)	Redis/Valkey password (not needed for Docker default)
`REDIS_PORT`	`6379`	Redis/Valkey port

Variable	Default	Description
`MAIL_ENABLED`	`false`	Set to `true` to enable password reset via email
`MAIL_MAILER`	`smtp`	Mail driver
`MAIL_HOST`	(empty)	SMTP server host
`MAIL_PORT`	`2525`	SMTP server port (Docker default: `587`)
`MAIL_USERNAME`	(null)	SMTP username
`MAIL_PASSWORD`	(null)	SMTP password
`MAIL_ENCRYPTION`	(null)	SMTP encryption (`tls`, `ssl`, or null)
`MAIL_FROM_ADDRESS`	(null)	Sender email address
`MAIL_FROM_NAME`	`${APP_NAME}`	Sender name

Variable	Default	Description
`SOLDER_REPO_LOCATION`	`/var/www/mods.solder.test/`	Path or URL to the mod repository. Trailing slash added automatically if omitted.
`SOLDER_MIRROR_URL`	`http://mods.solder.test/`	Public URL the launcher uses to download mod files. Trailing slash added automatically if omitted.
`SOLDER_MD5_CONNECT_TIMEOUT`	`5`	Seconds to wait when connecting for MD5 checksums
`SOLDER_MD5_FILE_TIMEOUT`	`30`	Seconds to wait when computing MD5 checksums
`SOLDER_DISABLE_MOD_API`	`false`	Set to `true` to disable `/api/mod` endpoints
`SOLDER_CORS_ORIGINS`	`*`	Allowed CORS origins (comma-separated or `*` for all)

Advanced Configuration

Logging

Variable	Default	Description
`LOG_CHANNEL`	`stack`	Log channel
`LOG_STACK`	`single`	Log stack channel

Queue & Broadcasting

Variable	Default	Description
`BROADCAST_CONNECTION`	`log`	Broadcast driver
`QUEUE_CONNECTION`	`sync`	Queue driver. Docker uses `redis`.

Session (advanced)

Variable	Default	Description
`SESSION_PATH`	`/`	Session cookie path
`SESSION_DOMAIN`	(null)	Session cookie domain

Application (rarely changed)