# Configuration Ignite is configured entirely through environment variables, read from a `.env` file (copied from `.env.example`, see [Installation](/installation)). This page is a grouped reference of the variables that matter for running the app. ## Core | Variable | What it does | Default / example | | --------------------- | --------------------------------------------------------------------------------------------------------------------------------------------------- | ----------------------- | | `APP_NAME` | Display name for the app, used in mail, page titles, and vite build. | `Ignite` | | `APP_ENV` | Runtime environment (`local`, `production`, etc). | `local` | | `APP_KEY` | Encryption key used for sessions, cookies, and encrypted data. Generate with `php artisan key:generate`. | empty until generated | | `APP_URL` | Base URL the app is served from. Matches the Docker setup's port by default; change it to `http://localhost:8000` for a native `php artisan serve`. | `http://localhost:8080` | | `APP_LOCALE` | Default application locale. | `en` | | `APP_FALLBACK_LOCALE` | Locale used when a translation is missing for `APP_LOCALE`. | `en` | ## Database | Variable | What it does | Default / example | | --------------- | -------------------------------------- | ----------------- | | `DB_CONNECTION` | Database driver Laravel connects with. | `pgsql` | | `DB_HOST` | Database host. | `127.0.0.1` | | `DB_PORT` | Database port. | `5432` | | `DB_DATABASE` | Database name. | `ignite` | | `DB_USERNAME` | Database user. | `postgres` | | `DB_PASSWORD` | Database password. | `secret` | PostgreSQL is the app's default database, both locally and in production. SQLite is used only by the automated test suite, not for local development. ## User data encryption Goal, entry, milestone and category text and the user's name are encrypted with a key per user. See [Data Encryption](/features/encryption) for how it works. | Variable | What it does | Default / example | | -------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | ------------------------------------------------------------------------- | | `USER_DATA_MASTER_KEY` | Master key that wraps every user's data key. Required. Generate with `php artisan key:generate --show` and keep a copy outside the server: losing it loses all user text. | empty until generated | | `USER_DATA_PREVIOUS_MASTER_KEYS` | Comma-separated previous master keys, kept only while `app:rotate-user-data-master-key` re-wraps the data keys. | unset by default | | `USER_DATA_KEYS_DB_URL` | PostgreSQL URL of a separate database for the wrapped user keys. Unset stores them in the main database. | unset by default (keys live in the main database, table `user_data_keys`) | ## AI assistant Optional. These variables give a self-hosted instance one AI configuration for all of its users; without them, each user adds their own key in settings. See [AI Assistant](/features/ai-assistant#instance-configuration). | Variable | What it does | Default / example | | --------------------------------------------------------------------------------------------------------------------------------------------------- | ---------------------------------------------------------------------------------------------------------------------------------------------------------------- | -------------------------- | | `AI_DEFAULT_PROVIDER` | Provider the instance uses, a name from `config/ai.php` (for example `anthropic`, `openai`, `gemini`, `ollama`). Unset means the instance provides no assistant. | unset by default | | `ANTHROPIC_API_KEY`, `OPENAI_API_KEY`, `GEMINI_API_KEY`, `OPENROUTER_API_KEY`, `GROQ_API_KEY`, `XAI_API_KEY`, `DEEPSEEK_API_KEY`, `MISTRAL_API_KEY` | API key of the matching provider. Only the default provider's key is used. | unset by default | | `OLLAMA_URL` | Base URL of a local Ollama server. No key is needed. | `http://localhost:11434` | | `OPENAI_COMPATIBLE_URL`, `OPENAI_COMPATIBLE_API_KEY` | Base URL and optional key of an OpenAI-compatible endpoint. | unset by default | | `AZURE_OPENAI_URL`, `AZURE_OPENAI_API_KEY`, `AZURE_OPENAI_DEPLOYMENT` | Azure OpenAI resource URL, key and deployment name. | unset by default | | `AWS_BEDROCK_REGION`, `AWS_BEARER_TOKEN_BEDROCK` | Amazon Bedrock region and bearer token. | `us-east-1`, unset | | `ANTHROPIC_URL`, `OPENAI_URL`, `GEMINI_URL`, `OPENROUTER_URL`, `GROQ_URL`, `XAI_URL`, `DEEPSEEK_URL`, `MISTRAL_URL` | Base URL override for a provider, for example to go through a proxy. It applies to the assistant and to the check made when a user saves a key. | each provider's public API | | `ANTHROPIC_VERSION` | Value of the `anthropic-version` header. | `2023-06-01` | ## Session, cache, and queue | Variable | What it does | Default / example | | ------------------ | --------------------------------------------- | ----------------- | | `SESSION_DRIVER` | Where session data is stored. | `database` | | `CACHE_STORE` | Where cached data is stored. | `database` | | `QUEUE_CONNECTION` | How queued jobs are dispatched and processed. | `database` | Locally, queued jobs are stored in the `jobs` database table and processed by a worker, `php artisan queue:listen` (part of `composer dev`, see [Installation](/installation)). Production overrides `QUEUE_CONNECTION` to `sync`, which runs queued jobs immediately, in-request, so a minimal deployment doesn't need a separate worker process. ## Mail | Variable | What it does | Default / example | | ------------------- | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | ------------------- | | `MAIL_MAILER` | Mail transport driver. | `log` | | `MAIL_HOST` | SMTP host (only used by SMTP-based mailers). | `127.0.0.1` | | `MAIL_PORT` | SMTP port. | `2525` | | `MAIL_SCHEME` | Connection scheme for the SMTP mailer: `smtp` for STARTTLS (port 587), `smtps` for implicit TLS (port 465). Leave unset to let Symfony infer it from the port. | `null` | | `MAIL_USERNAME` | SMTP username. | `null` | | `MAIL_PASSWORD` | SMTP password. | `null` | | `MAIL_FROM_ADDRESS` | From address on outgoing mail. | `hello@example.com` | | `MAIL_FROM_NAME` | From name on outgoing mail. | `${APP_NAME}` | | `MAIL_REPLY_TO` | Address applied as `Reply-To` on every outgoing message, so replies reach a monitored inbox instead of the no-reply From address. Leave unset to send no `Reply-To` header. | unset by default | | `MAIL_TIMEOUT` | Seconds the SMTP mailer waits on a stalled connection before giving up. Unset means PHP's own `default_socket_timeout` applies, which is usually 60. | `null` | In development, `MAIL_MAILER=log` writes outgoing mail to `storage/logs/laravel.log` instead of sending it, so no SMTP credentials are required to try the app locally. ::: warning `MAIL_ENCRYPTION` does nothing It was replaced by `MAIL_SCHEME` on this version of Laravel, but many provider guides still show the old variable. Setting it is silently ignored. ::: Ignite only sends two emails, both tied to authentication: email verification and password reset. Both are queued notifications, which matters if `QUEUE_CONNECTION` is not `sync`. See [Self-Hosting](/self-hosting) for the consequences. ::: tip Set `MAIL_TIMEOUT` to something short, around 10 seconds, whenever `QUEUE_CONNECTION=sync`. Mail is then sent inside the web request, so an unresponsive SMTP server would otherwise hold a registration or password-reset request open for the full socket timeout. ::: ### Sending real email Ignite uses Laravel's stock mailers and ships no mail-provider package, so any SMTP service works with the standard variables: ```ini MAIL_MAILER=smtp MAIL_HOST=smtp.your-provider.example MAIL_PORT=587 MAIL_SCHEME=smtp MAIL_USERNAME=your-username MAIL_PASSWORD=your-password MAIL_FROM_ADDRESS=no-reply@your-domain MAIL_REPLY_TO=contact@your-domain ``` Most transactional providers issue an API key that doubles as the SMTP password, and require the `MAIL_FROM_ADDRESS` domain to be verified in their dashboard before they will accept mail. Check your provider's own SMTP guide for the host, port, and username to use. ### When SMTP is blocked ::: warning Many hosting platforms block outbound SMTP on their lower tiers to protect their IP reputation from abuse, usually on every port at once (25, 465, 587 and 2525). The symptom is a connection timeout rather than an authentication error, and the same credentials work fine from your laptop. ::: The fix is to send over an HTTPS API instead of SMTP, since port 443 is never blocked. Laravel ships transports for several providers; `resend/resend-php` is included as a dependency, so that one needs no extra install: ```ini MAIL_MAILER=resend RESEND_KEY=your-api-key ``` `MAIL_FROM_ADDRESS`, `MAIL_FROM_NAME` and `MAIL_REPLY_TO` still apply. The `MAIL_HOST`, `MAIL_PORT`, `MAIL_SCHEME`, `MAIL_USERNAME`, `MAIL_PASSWORD` and `MAIL_TIMEOUT` variables configure the SMTP mailer only and are ignored. An HTTPS call is also a single round trip rather than SMTP's several, which is worth having when mail is sent inside the request on a `sync` queue. ## Logging | Variable | What it does | Default / example | | ------------- | ----------------------------------------- | ----------------- | | `LOG_CHANNEL` | Channel used for all application logging. | `stack` | | `LOG_STACK` | Channels the `stack` channel writes to. | `daily` | | `LOG_LEVEL` | Minimum severity that gets recorded. | `debug` | The default writes rotating files under `storage/logs`, which suits a VPS or bare-metal install. ::: warning On a container platform, set `LOG_CHANNEL=stderr` Docker, Railway, Fly, Render and Kubernetes all collect logs from the container's standard output and standard error, and none of them read files out of the filesystem. Left on the file default, logs are invisible to the platform's log viewer and are discarded whenever the container is replaced, which happens on every deploy. ```ini LOG_CHANNEL=stderr ``` This matters more than it looks. When an email fails to send, Ignite deliberately keeps the request working and records the failure in the log instead of surfacing an error, so that log line is the only evidence the failure happened. ::: ## Feature gates | Variable | What it does | Default / example | | --------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------ | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | | `VERIFY_EMAIL` | Toggles the email-verification wall on registration and login. Production runs with it enabled. | `false` in `.env.example` for local dev; the app's own config default is `true` when unset, so production keeps verification enforced unless explicitly disabled. Requires working mail, since it gates every authenticated route. See the authentication feature page. | | `FORMBRICKS_WORKSPACE_ID` | Workspace ID for the Formbricks feedback survey integration. | unset by default (feature disabled) | | `FORMBRICKS_APP_URL` | Base URL of the Formbricks instance. | `https://app.formbricks.com` | | `FORMBRICKS_WEBHOOK_SECRET` | Secret used to verify incoming Formbricks webhooks. | unset by default | | `DISCORD_OPS_ENABLED` | Toggles sending operational notifications to a Discord webhook. | `false` | | `DISCORD_OPS_WEBHOOK_URL` | Discord webhook URL that receives operational notifications when enabled. | unset by default | | `MCP_LOCAL_USER` | Email address of the user the MCP server acts as over the local stdio transport. Leave unset to expose no tools over stdio; the HTTP transport is unaffected either way. | unset by default. See the MCP server feature page | | `GITHUB_CLIENT_ID` | GitHub OAuth client id. Together with the secret, makes the GitHub sign-in button and its connected accounts row appear. | unset by default (provider hidden). See the authentication feature page. | | `GITHUB_CLIENT_SECRET` | GitHub OAuth client secret. | unset by default | | `GOOGLE_CLIENT_ID` | Google OAuth client id. Together with the secret, makes the Google sign-in button and its connected accounts row appear. | unset by default (provider hidden). See the authentication feature page. | | `GOOGLE_CLIENT_SECRET` | Google OAuth client secret. | unset by default | Each of these gates a feature that is off by default until its variable is set. See the corresponding feature page for setup details on the Formbricks survey and Discord operational notifications.