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 |
Database
| 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 |
Cache & Session
| 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 |
Mail
| 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_SCHEME |
(unset) |
Optional SMTP scheme override: smtp for SMTP with automatic STARTTLS when supported, or smtps for implicit TLS. When unset, empty, or null, Laravel selects smtps on port 465 and smtp otherwise, including in Docker. |
MAIL_FROM_ADDRESS |
(null) |
Sender email address |
MAIL_FROM_NAME |
${APP_NAME} |
Sender name |
No .env migration is required for an existing working mail configuration. MAIL_ENCRYPTION was already unused by Laravel and may be removed as optional cleanup. Set MAIL_SCHEME only to override automatic selection; its accepted values are smtp and smtps, not tls or ssl.
Solder
| Variable |
Default |
Description |
SOLDER_REPO_LOCATION |
/var/www/mods.example.com/ |
Path or URL to the mod repository. Trailing slash added automatically if omitted. |
SOLDER_MIRROR_URL |
http://mods.example.com/ |
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 public /api/mod reads; authorized manager bearer tokens retain access |
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)
| Variable |
Default |
Description |
APP_LOCALE |
en |
Application locale |
APP_FALLBACK_LOCALE |
en |
Fallback locale |
APP_FAKER_LOCALE |
en_US |
Faker locale for seeding |
APP_MAINTENANCE_DRIVER |
file |
Maintenance mode driver |
APP_MAINTENANCE_STORE |
database |
Maintenance mode store |
BCRYPT_ROUNDS |
12 |
Bcrypt hashing rounds |