Environment Variables

Complete reference for the variables read from .env (or equivalent container environment). Set these before starting the application; most require a restart to take effect.

See Environment configuration for how to create and populate your .env file.

Application

Variable	Default	Description
`APP_NAME`	`Inventorix`	Application name shown in the UI and email subjects.
`APP_ENV`	`local`	Environment name. Set to `production` in production.
`APP_KEY`	(empty)	32-byte encryption key. Generate with `php artisan key:generate`. Required.
`APP_DEBUG`	`true`	Show detailed error pages. Set to `false` in production.
`APP_URL`	`http://localhost`	Canonical URL. Used for link generation, OAuth callbacks, and queue jobs.
`APP_LOCALE`	`de`	Default UI locale.
`APP_FALLBACK_LOCALE`	`en`	Locale used when a translation key is missing.
`APP_FAKER_LOCALE`	`en_US`	Locale for Faker (seeder only).
`APP_MAINTENANCE_DRIVER`	`file`	Driver for maintenance mode state (`file` or `database`).
`APP_MAINTENANCE_STORE`	`database`	Storage driver for maintenance-mode state (commented out by default in `.env.example`).
`PHP_CLI_SERVER_WORKERS`	`4`	Worker count for the built-in PHP CLI server (local dev only).
`BCRYPT_ROUNDS`	`12`	Bcrypt cost factor for password hashing.

Logging

Variable	Default	Description
`LOG_CHANNEL`	`stack`	Primary log channel.
`LOG_STACK`	`single`	Channels combined when `LOG_CHANNEL=stack`.
`LOG_DEPRECATIONS_CHANNEL`	`null`	Channel for deprecation warnings.
`LOG_LEVEL`	`debug`	Minimum log level. Set to `warning` or `error` in production.

Database

Variable	Default	Description
`DB_CONNECTION`	`sqlite`	Database driver (`sqlite`, `mysql`, `pgsql`).
`DB_HOST`	`127.0.0.1`	Database host (MySQL/PostgreSQL only).
`DB_PORT`	`3306`	Database port.
`DB_DATABASE`	`inventorix`	Database name or path (SQLite: absolute path to `.sqlite` file).
`DB_USERNAME`	`root`	Database username.
`DB_PASSWORD`	(empty)	Database password.

Session

Variable	Default	Description
`SESSION_DRIVER`	`database`	Session storage backend (`database`, `redis`, `file`, `cookie`).
`SESSION_LIFETIME`	`120`	Session lifetime in minutes.
`SESSION_ENCRYPT`	`false`	Encrypt session payload at rest. Set to `true` in production.
`SESSION_PATH`	`/`	Cookie path.
`SESSION_DOMAIN`	`null`	Cookie domain. Set to your hostname in production.

Cache

Variable	Default	Description
`CACHE_STORE`	`database`	Default cache store (`database`, `redis`, `file`, `array`, `memcached`).
`CACHE_PREFIX`	(empty)	Optional prefix for cache keys (useful when sharing a Redis instance).
`MEMCACHED_HOST`	`127.0.0.1`	Memcached server hostname (applies when `CACHE_STORE=memcached`).

Queue

Variable	Default	Description
`QUEUE_CONNECTION`	`database`	Default queue driver (`database`, `redis`, `sync`).

Broadcast

Variable	Default	Description
`BROADCAST_CONNECTION`	`log`	Broadcast driver. `log` disables real-time broadcasting.

Filesystem

Variable	Default	Description
`FILESYSTEM_DISK`	`local`	Default disk for file uploads (`local` or `s3`).

Redis

Variable	Default	Description
`REDIS_CLIENT`	`phpredis`	PHP Redis client (`phpredis` or `predis`).
`REDIS_HOST`	`127.0.0.1`	Redis server hostname.
`REDIS_PASSWORD`	`null`	Redis authentication password.
`REDIS_PORT`	`6379`	Redis server port.

Mail

Variable	Default	Description
`MAIL_MAILER`	`log`	Mail driver (`smtp`, `log`, `postmark`, `resend`, `postal`, `ses`). `log` discards all mail to the log.
`MAIL_SCHEME`	`null`	SMTP transport scheme (`smtp` or `smtps`).
`MAIL_HOST`	`127.0.0.1`	SMTP server hostname.
`MAIL_PORT`	`2525`	SMTP server port.
`MAIL_USERNAME`	`null`	SMTP authentication username.
`MAIL_PASSWORD`	`null`	SMTP authentication password.
`MAIL_FROM_ADDRESS`	`hello@example.com`	Default sender address.
`MAIL_FROM_NAME`	`${APP_NAME}`	Default sender display name.

Storage / S3

Variable	Default	Description
`AWS_ACCESS_KEY_ID`	(empty)	AWS (or S3-compatible) access key ID.
`AWS_SECRET_ACCESS_KEY`	(empty)	AWS (or S3-compatible) secret access key.
`AWS_DEFAULT_REGION`	`us-east-1`	AWS region.
`AWS_BUCKET`	(empty)	S3 bucket name.
`AWS_USE_PATH_STYLE_ENDPOINT`	`false`	Use path-style S3 URLs (required for MinIO and some S3-compatible services).

See Storage configuration.

SSO / Microsoft Entra ID

Variable	Default	Description
`MS_LOGIN_ENABLED`	`false`	Show the “Login via Entra ID” button on the login page.
`MS_CLIENT_ID`	(empty)	Microsoft Entra application (client) ID.
`MS_CLIENT_SECRET`	(empty)	Microsoft Entra client secret.
`MS_TENANT_ID`	(empty)	Microsoft Entra tenant (directory) ID.
`MS_REDIRECT_URI`	`${APP_URL}/auth/microsoft/callback`	OAuth redirect URI. Must match the URI registered in Entra.

See Authentication configuration.

Runtime / Octane

Inventorix uses Laravel Octane in the Docker image. Octane configuration lives in config/octane.php; no custom env variables are required beyond the standard APP_* keys. The server is started with php artisan octane:start.

Deploy / container

Variable	Default	Description
`VITE_APP_NAME`	`${APP_NAME}`	App name exposed to the Vite frontend build.
`RUN_MIGRATIONS`	`true`	When `true`, runs `php artisan migrate --force` automatically on container start. Set to `false` for multi-replica deployments; run migrations as a one-shot init container instead.

Configuration-only keys (not in `.env.example`)

These variables are read by a config file but are not present in .env.example. They are typically set through the admin Settings UI at runtime (values are persisted to the database), or may be supplied as environment variables if you prefer.

Multi-factor authentication (`config/auth.php`)

Variable	Default	Description
`AUTH_MULTIFACTOR_AUTH_ENABLED`	`true`	Allow users to enrol in TOTP-based MFA.
`AUTH_MULTIFACTOR_AUTH_FORCE`	`false`	Force MFA enrolment for all users.
`AUTH_MULTIFACTOR_AUTH_RECOVERABLE`	`false`	Allow MFA recovery codes.