Configuration
Most of the settings are plain Laravel. Here we only cover the keys and files that are specific to the kits. If you want every .env key with its default, see the Environment reference.
Key .env values
| Key | Example (Vue kit) | Used for |
|---|---|---|
APP_URL | http://vue.test | Fortify passkeys, and the scheme (http / https) of tenant links |
APP_DOMAIN | vue.test | The central domain, and the suffix for tenant subdomains |
DB_CONNECTION, DB_DATABASE | mysql, saas_laravel_vue | Central database; tenant databases are created on the same server |
SESSION_DRIVER | database | Sessions |
QUEUE_CONNECTION | database | Queued emails and jobs |
CACHE_STORE | database | Cache |
MAIL_MAILER | log | Writes emails to the log until you configure a real mailer |
Here's where the database-backed drivers keep their data:
| Driver | Central domain | Tenant domain |
|---|---|---|
| Sessions | Central sessions table | That tenant's sessions table (sessions use the active connection) |
| Cache | Central cache table | Tenant databases have their own cache tables |
| Queue | Central jobs table | Also the central jobs table (see config/queue.php) |
config/tenancy.php
This file reads APP_DOMAIN twice. Once as central_domains (a single-item array), and once as domain (the suffix for tenant subdomains).
| Key | Value | Meaning |
|---|---|---|
tenant_model | App\Models\Tenant | Integer auto-increment IDs |
domain_model | App\Models\Domain | Adds is_primary, app_name, locale, auth_features |
central_domains | [env('APP_DOMAIN')] | Requests on any other host initialize tenancy |
domain | env('APP_DOMAIN') | Tenant domains are <sub>.<domain> |
bootstrappers | Database, Cache, Filesystem, Queue | Redis bootstrapper is commented out |
database.central_connection | env('DB_CONNECTION', 'central') | |
database.prefix | 'tenant' (React: env('TENANCY_DB_PREFIX', 'tenant')) | Tenant DB name = prefix + tenant id |
database.managers | sqlite, mysql, mariadb, pgsql | |
filesystem.disks | local, public | Suffixed per tenant (storage/tenant<id>/...) |
migration_parameters | --path => database/migrations/tenant | Used by tenants:migrate |
seeder_parameters | --class => TenantDatabaseSeeder | Used by tenants:seed and tenant creation |
Read Database → Tenant database naming before you change the prefix.
config/fortify.php
| Key | Value |
|---|---|
guard / passwords | web / central_users (switched to tenant / tenant_users on tenant domains) |
home | /dashboard |
lowercase_usernames | true |
features | registration, resetPasswords, emailVerification, twoFactorAuthentication (confirm + confirmPassword), passkeys (confirmPassword) |
passkeys.relying_party_id | Host of APP_URL |
passkeys.user_handle_secret | env('PASSKEYS_USER_HANDLE_SECRET', config('app.key')) |
The feature list is the maximum
A tenant domain can turn individual features off, but it can't turn on a feature that's missing here. See Authentication → Per-domain features.
config/auth.php
There are two session guards, and both use App\Models\User:
| Guard | Provider | Password broker |
|---|---|---|
web | central_users | central_users |
tenant | tenant_users | tenant_users |
AUTH_PASSWORD_TIMEOUT (default 10800 seconds) sets how long a password confirmation stays valid.
config/permission.php and config/permissions/*
| File | Purpose |
|---|---|
config/permission.php | Standard spatie config: teams disabled, wildcard permissions disabled, 24-hour cache |
config/permissions/*.php | Central permissions and the default system roles for each |
config/permissions/tenant/*.php | Tenant permissions and the default system roles for each |
Each file shows up as one permission group in the UI, and the file name is the group key. For the file format and examples, see Users, roles & permissions → Permissions.
config/inertia-lang.php
| Key | Value |
|---|---|
lang_path | base_path('lang') |
output_lang | resource_path('js/lang') |
php artisan erag:generate-lang takes the PHP translation files in lang_path and exports them as JSON to output_lang. See Localization.
config/queue.php
Every queued job, including jobs dispatched inside a tenant, goes into the central jobs table. That means one worker can process jobs for every tenant.
It works because the database queue connection reads DB_QUEUE_CONNECTION, which falls back to DB_CONNECTION (the central connection name, e.g. mysql) rather than the tenant connection. When each job runs, stancl's QueueTenancyBootstrapper restores the tenant context.
View the queue connection
'database' => [
'driver' => 'database',
'connection' => env('DB_QUEUE_CONNECTION', env('DB_CONNECTION')),
'table' => env('DB_QUEUE_TABLE', 'jobs'),
'queue' => env('DB_QUEUE', 'default'),
'retry_after' => (int) env('DB_QUEUE_RETRY_AFTER', 90),
],There's more in Local development → Queue worker.
Other files
| File | Notes |
|---|---|
config/app.php | locale / fallback_locale from APP_LOCALE / APP_FALLBACK_LOCALE (en) |
config/data.php | spatie/laravel-data defaults |
config/inertia.php | Inertia server settings |
bootstrap/app.php | Middleware registration, aliases (auth, guest, central.only, permission, role) and error page rendering |
bootstrap/providers.php | App and module service providers |