Skip to content

Environment reference

The variables in .env that matter, and which ones the installer writes for you.

1 min read

Most configuration belongs in Settings, not here. .env holds the handful of values that have to exist before the database does.

Application#

Variable Notes
APP_NAME Used in email subjects and titles.
APP_ENV production on a live site.
APP_KEY Generated during install. Never change it — it decrypts your stored Paddle credentials and every active session.
APP_DEBUG Must be false in production. true exposes stack traces and configuration to visitors.
APP_URL Your public URL, with scheme. Signed links and email links are built from it.
APP_LOCALE Default interface language.

Database#

DB_CONNECTION=mysql
DB_HOST=127.0.0.1
DB_PORT=3306
DB_DATABASE=your_database
DB_USERNAME=your_user
DB_PASSWORD=your_password

Drivers#

Variable Shipped value
SESSION_DRIVER database
CACHE_STORE database
QUEUE_CONNECTION database
FILESYSTEM_DISK plugins

All three of the first group can be moved to Redis on a busier install without any code change.

Release storage#

MYPLUGIN_PLUGINS_DISK names the disk your uploaded release archives live on. It defaults to plugins, a private disk that is never web-accessible — downloads are always streamed through an authorised controller, never linked to directly.

Social sign-in#

SOCIALITE_ALLOWED_PROVIDERS is a comma-separated list; it ships as google,github. Each enabled provider also needs its client ID, secret, and redirect URL in .env.

Licensing (resellers only)#

These control how your copy was licensed to you, and how copies you sell would be licensed. They matter only if you are reselling the panel itself. See License drivers.

LICENSE_DRIVER=remote
LICENSE_PRODUCT=panel
LICENSE_SERVER=https://your-license-server.example
LICENSE_PUBLIC_KEY=

After editing#

Clear the cached configuration, or your change will not be picked up:

php artisan optimize:clear