Application settings
This page covers application-level configuration: the core environment variables that control the app’s identity and behaviour, and the in-app Settings cluster where administrators can adjust settings at runtime without touching .env.
Core environment variables
Section titled “Core environment variables”| Variable | Default | Purpose |
|---|---|---|
APP_NAME | Inventorix | Application name shown in the browser title and default “from name” for email |
APP_URL | http://localhost | Canonical URL; used in generated links and the default SSO redirect URI |
APP_ENV | local | Environment name (local, production). Affects error reporting and optimisation. |
APP_DEBUG | true | Show detailed error pages. Set to false in production. |
APP_KEY | (empty) | Encryption key. Generate with php artisan key:generate. Required. |
APP_LOCALE | de | Default application locale |
APP_FALLBACK_LOCALE | en | Fallback locale when a translation is missing |
Session
Section titled “Session”| Variable | Default | Purpose |
|---|---|---|
SESSION_DRIVER | database | Session backend (database, redis, file, cookie) |
SESSION_LIFETIME | 120 | Idle timeout in minutes |
SESSION_ENCRYPT | false | Encrypt session data at rest. Set to true in production. |
SESSION_DOMAIN | (null) | Cookie domain. Lock to your hostname in production. |
In-app Settings cluster
Section titled “In-app Settings cluster”The admin panel exposes a Settings section in the sidebar. It hosts four pages that store their values in the database via spatie/laravel-settings. Settings are applied to the Laravel runtime on every request and queue job without requiring a worker restart.
General
Section titled “General”Path: Settings → General
| Setting | Purpose |
|---|---|
| Application name | Overrides config('app.name') at runtime. Used as the default mail “from name”. The Filament panel brand name is hardcoded to Inventorix in AppPanelProvider and is not affected by this setting. |
Authentication
Section titled “Authentication”Path: Settings → Authentication
Covers Microsoft Entra ID SSO credentials and multi-factor authentication toggles. Documented in detail on Authentication & SSO.
Path: Settings → Mail
Covers outbound mail transport, from address/name, and transport-specific credentials. Documented in detail on Mail & SMTP.
Warranty notifications
Section titled “Warranty notifications”Path: Settings → Warranty
Controls automated warranty-expiry digest emails.
| Setting | Purpose |
|---|---|
| Enabled | Activates the scheduled warranty-expiry check and digest email |
| Recipients | List of email addresses that receive the digest |
| Lead days | Days before expiry to include an asset in the digest. Default: 90, 30, 7 days. Multiple values are supported; each triggers a separate check. |
The warranty digest is sent via the configured mail transport (Settings → Mail). A Send test digest button in the page header immediately scans for expiring assets and sends to the configured recipients, so you can verify the setup before the scheduled run fires.
Handover document settings
Section titled “Handover document settings”Handover document appearance is controlled by environment variables in config/handover.php. These are not exposed in the admin UI.
| Variable | Default | Purpose |
|---|---|---|
APP_COMPANY_NAME | (falls back to APP_NAME) | Company name printed on handover documents |
APP_COMPANY_LOGO | (null) | Path to the company logo file used in handover PDFs |
HANDOVER_DISK | local | Filesystem disk for storing generated handover PDFs |
The handover PDF is always rendered on A4 paper in portrait orientation.