Appearance
Environment (.env)
The .env file in the application folder (apps/standalone in the source, the top folder of a release) holds the server's settings: the edition, the database, where recordings are stored, keys for AI and payments. The installer writes the essentials; everything else has a working default. Many options can instead be changed by administrators in the dashboard (Settings › Installation), and those win once saved.
After editing .env, run php artisan config:clear if your server caches configuration (php artisan config:cache), and restart the queue worker (php artisan queue:restart) so it reads the new values.
Keep it private
.env holds your database password, the app key and API secrets. Only public/ may be reachable from the web, and .env must be in your backups. Never change APP_KEY on a running site: stored secrets and sessions depend on it.
Keys marked Dashboard can also be set in Settings › Installation (administrators); a value saved there is used instead of .env.
Edition
| Key | Default | What it does |
|---|---|---|
REPLORA_MODE | single | single (self-hosted for one owner and their team) or saas (sign-up, plans, billing, public website; needs the saas/ folder). The installer's --mode writes it. |
REPLORA_SAAS_PATH | saas | Folder of the SaaS modules and pages, relative to the app folder. |
REPLORA_SIGNUP | true | SaaS: self-service sign-up open. Dashboard. |
REPLORA_INSTALLED | false | true treats the app as installed without the marker file (development, tests). |
REPLORA_INSTALL_MARKER | app/replora-installed.json | The marker file the installer writes when it finishes (relative to storage/); it closes the installer for good. |
REPLORA_EDITION | — | Build time only (pnpm build): single builds the dashboard without SaaS pages. Not read by the server. |
Application
| Key | Default | What it does |
|---|---|---|
APP_NAME | Replora | Product name in page titles and emails. Dashboard. |
APP_ENV | production | production on live servers (the installer sets it). |
APP_KEY | (generated) | Encrypts sessions and stored secrets. Generated by the installer or php artisan key:generate. |
APP_PREVIOUS_KEYS | empty | Old keys, comma separated, still accepted for decryption while you rotate APP_KEY. |
APP_DEBUG | false | Never true on a public server (shows error details). |
APP_URL | http://localhost | The address people open the dashboard with. Also the only host names the app answers to (forged Host headers are refused), the base of links in emails and of the tracking snippet. |
APP_LOCALE | en | Default interface language (en es fr de pt it ru zh ja ko tr id ar). Dashboard. |
APP_FALLBACK_LOCALE | en | Language used when a text is missing. |
APP_FAKER_LOCALE | en_US | Test data only. |
APP_MAINTENANCE_DRIVER, APP_MAINTENANCE_STORE | file, database | Where Laravel keeps the maintenance flag (cache with a shared store on several servers). |
SANCTUM_STATEFUL_DOMAINS | localhost addresses plus APP_URL's host | Hosts (with port) where the dashboard's session sign-in works, comma separated. The installer writes it from the site address. |
SANCTUM_TOKEN_PREFIX | empty | Prefix for new API tokens (helps secret scanners recognise them). |
REPLORA_DESIGN | classic | The dashboard's design for everyone: classic, daylight, midnight, compact, soft or contrast. Dashboard. |
REPLORA_APP_RETURN_URLS | empty | Comma-separated URL prefixes the mobile app may ask payment pages to return to (its deep links), e.g. replora://billing. This site's own URLs are always allowed. |
BCRYPT_ROUNDS | 12 | Password hashing cost. |
AUTH_GUARD, AUTH_MODEL, AUTH_PASSWORD_BROKER, AUTH_PASSWORD_RESET_TOKEN_TABLE, AUTH_PASSWORD_TIMEOUT | Laravel defaults | Laravel authentication internals; leave them. |
Database
Replora uses PostgreSQL (the installer writes DB_CONNECTION=pgsql).
| Key | Default | What it does |
|---|---|---|
DB_CONNECTION | sqlite (installer: pgsql) | pgsql. |
DB_HOST | 127.0.0.1 | Database server. |
DB_PORT | 5432 | |
DB_DATABASE | laravel | Database name. |
DB_USERNAME | root | |
DB_PASSWORD | empty | |
DB_URL | empty | One connection URL instead of the keys above. |
DB_CHARSET | utf8 | |
DB_SSLMODE | prefer | PostgreSQL SSL mode (require, verify-full …) for managed databases. |
DB_SOCKET, DB_COLLATION, DB_FOREIGN_KEYS, DB_ENCRYPT, DB_TRUST_SERVER_CERTIFICATE, MYSQL_ATTR_SSL_CA | Laravel defaults | Used by other drivers only. |
Cache, sessions and queue
| Key | Default | What it does |
|---|---|---|
CACHE_STORE | database (installer: file) | file, database or redis. Use redis or database on several servers. |
CACHE_PREFIX | from APP_NAME | Key prefix in a shared cache. |
DB_CACHE_CONNECTION, DB_CACHE_TABLE, DB_CACHE_LOCK_CONNECTION, DB_CACHE_LOCK_TABLE, CACHE_STORAGE_DISK, CACHE_STORAGE_PATH | Laravel defaults | Details of the database and file stores. |
MEMCACHED_HOST, MEMCACHED_PORT, MEMCACHED_USERNAME, MEMCACHED_PASSWORD, MEMCACHED_PERSISTENT_ID, DYNAMODB_CACHE_TABLE, DYNAMODB_ENDPOINT | Laravel defaults | Other cache drivers. |
SESSION_DRIVER | database (installer: file) | file, database or redis. Not file on several servers. |
SESSION_LIFETIME | 120 | Minutes of inactivity before signing out (unless "remember me"). |
SESSION_ENCRYPT | false | Encrypt session data. |
SESSION_SECURE_COOKIE | automatic | true sends the session cookie over HTTPS only. |
SESSION_DOMAIN, SESSION_PATH, SESSION_SAME_SITE (lax), SESSION_HTTP_ONLY (true), SESSION_PARTITIONED_COOKIE, SESSION_EXPIRE_ON_CLOSE, SESSION_CONNECTION, SESSION_STORE, SESSION_TABLE | Laravel defaults | Cookie and storage details. |
QUEUE_CONNECTION | database | database, redis, or sync (no worker: recordings are processed during the request; only for small sites). |
QUEUE_FAILED_DRIVER | database-uuids | Where failed jobs are kept. |
DB_QUEUE_CONNECTION, DB_QUEUE_TABLE, DB_QUEUE, DB_QUEUE_RETRY_AFTER, REDIS_QUEUE_CONNECTION, REDIS_QUEUE, REDIS_QUEUE_RETRY_AFTER, BEANSTALKD_QUEUE_HOST, BEANSTALKD_QUEUE, BEANSTALKD_QUEUE_RETRY_AFTER, SQS_PREFIX, SQS_QUEUE, SQS_SUFFIX | Laravel defaults | Queue driver details. |
Redis
| Key | Default |
|---|---|
REDIS_CLIENT | phpredis |
REDIS_HOST, REDIS_PORT, REDIS_USERNAME, REDIS_PASSWORD | 127.0.0.1, 6379, empty, empty |
REDIS_URL | empty (one URL instead) |
REDIS_DB, REDIS_CACHE_DB | 0, 1 |
REDIS_CLUSTER, REDIS_PREFIX, REDIS_PERSISTENT, REDIS_MAX_RETRIES, REDIS_BACKOFF_ALGORITHM, REDIS_BACKOFF_BASE, REDIS_BACKOFF_CAP, REDIS_CACHE_CONNECTION, REDIS_CACHE_LOCK_CONNECTION, REDIS_TIMEOUT | Laravel defaults |
Recordings
| Key | Default | What it does |
|---|---|---|
RECORDINGS_DRIVER | local | local (storage/app/recordings) or s3 (Amazon S3, Cloudflare R2, MinIO and other S3-compatible storage). |
RECORDINGS_BUCKET | recordings | S3 bucket. |
RECORDINGS_ENDPOINT | empty | S3 endpoint, e.g. https://<account>.r2.cloudflarestorage.com or http://127.0.0.1:9000 (path-style addresses are used). |
RECORDINGS_KEY, RECORDINGS_SECRET | empty | S3 access key and secret. |
RECORDINGS_REGION | us-east-1 | S3 region (auto for R2). |
RECORDINGS_DEFAULT_RETENTION_DAYS | 30 | Retention of new websites (7, 30, 90, 180 or 365). Dashboard. |
RECORDINGS_INGEST_QUEUE | default | ingest keeps recording batches on their own queue (run php artisan queue:work --queue=ingest plus a worker for the rest), so bursts never delay email, alerts and AI jobs. |
RECORDINGS_INGEST_PER_MINUTE | 600 | Tracker requests (batches and rules) accepted per minute from one IP address. A visitor sends about 12 a minute. Dashboard. |
RECORDINGS_CACHE_STYLESHEETS | true | Keep copies of the stylesheets recorded pages link to, so replays keep their look. |
RECORDINGS_STYLESHEETS_ALLOW_PRIVATE | empty (= only in the Single user edition) | May stylesheet copies be fetched from private and local addresses (when the host is one of the site's allowed domains). Dashboard. |
REPLORA_DEMO_SITE | empty | The id of a website that records the public demo page /demo (its domain must be this server's host). Empty: no demo page. Dashboard. |
REPLORA_DEMO_RETENTION_DAYS | 1 | Days the demo's recordings are kept. Dashboard. |
REPLORA_PLAYER_THEME | classic | The replay player's control bar: classic, minimal, cinema, glass, capsule or studio. Dashboard. |
See Recording storage and Scaling to high traffic.
Live updates
| Key | Default | What it does |
|---|---|---|
REPLORA_REALTIME | polling | polling (HTTP, no extra server) or websocket (Laravel Reverb; set BROADCAST_CONNECTION=reverb and the REVERB_* keys, run php artisan reverb:start). |
REPLORA_POLL_SECONDS | 5 | Polling interval (at least 2). |
BROADCAST_CONNECTION | null | reverb for WebSockets. |
REVERB_APP_ID, REVERB_APP_KEY, REVERB_APP_SECRET | empty | The Reverb app's credentials (your own values). |
REVERB_HOST, REVERB_PORT, REVERB_SCHEME | empty, 443, https | Where browsers connect. |
REVERB_SERVER_HOST, REVERB_SERVER_PORT, REVERB_SERVER_PATH | 0.0.0.0, 8080, empty | Where the Reverb server listens. |
REVERB_SCALING_ENABLED, REVERB_SCALING_CHANNEL | false, reverb | Share connections across several Reverb servers through Redis. |
REVERB_SERVER, REVERB_MAX_REQUEST_SIZE, REVERB_APP_PING_INTERVAL, REVERB_APP_ACTIVITY_TIMEOUT, REVERB_APP_MAX_CONNECTIONS, REVERB_APP_MAX_CHANNELS_PER_CONNECTION, REVERB_APP_MAX_MESSAGE_SIZE, REVERB_APP_ACCEPT_CLIENT_EVENTS_FROM, REVERB_APP_RATE_LIMITING_ENABLED, REVERB_APP_RATE_LIMIT_MAX_ATTEMPTS, REVERB_APP_RATE_LIMIT_DECAY_SECONDS, REVERB_APP_RATE_LIMIT_TERMINATE, REVERB_PULSE_INGEST_INTERVAL, REVERB_TELESCOPE_INGEST_INTERVAL | Reverb defaults | Reverb tuning. |
PUSHER_APP_ID, PUSHER_APP_KEY, PUSHER_APP_SECRET, PUSHER_APP_CLUSTER, PUSHER_HOST, PUSHER_PORT, PUSHER_SCHEME, ABLY_KEY, MERCURE_* | empty | Other broadcasters Laravel supports; Replora's live view uses Reverb or polling. |
AI (Claude)
| Key | Default | What it does |
|---|---|---|
ANTHROPIC_API_KEY | empty | The Anthropic API key. Without it AI summaries, plain-words search, Ask AI and site digests say they aren't set up. Dashboard. |
REPLORA_AI_MODEL | claude-opus-5-5 | The Claude model. Dashboard. |
REPLORA_AI_EFFORT | low | How much the model thinks for summaries. Dashboard. |
REPLORA_ASSISTANT_EFFORT | medium | How much the model thinks for Ask AI. Dashboard. |
REPLORA_HELP_AI | true | The help center answers questions with AI (needs the key). Dashboard. |
REPLORA_HELP_CONTACT_URL | empty | Where "Contact us" in the help widget leads (an address or mailto:); empty hides it. Dashboard. |
See AI features.
Licensing and updates
| Key | Default | What it does |
|---|---|---|
REPLORA_LICENSE_URL | https://altara.digital/api/verify-purchase | The license server purchase codes are checked with. |
REPLORA_LICENSE_REQUIRED | true | false (bundled review builds) lets the installer go on without a purchase code; the System page then asks for one. |
REPLORA_LICENSE_FILE | storage/app/replora-license.json | Where the verified purchase code is kept. |
REPLORA_UPDATE_FEED | set by releases | The release manifest URL for one-click updates. |
REPLORA_UPDATE_KEY | set by releases | The Ed25519 public key (base64) release signatures are checked with. Without a feed and a key, updates are installed by uploading files. |
Release tooling (on the machine that builds releases, not on servers): REPLORA_RELEASE_KEY (path to the release signing key) and REPLORA_CORE_KEY (path to the core-pack signing key); see Releases & module packs.
Security and uploads
| Key | Default | What it does |
|---|---|---|
RECAPTCHA_OFF | false | true switches reCAPTCHA off from the server when a wrong key locks everyone out (the keys stay). Same as php artisan replora:recaptcha off. |
REPLORA_CLAMAV | empty | A ClamAV daemon that scans uploaded files, e.g. unix:///run/clamav/clamd.ctl or tcp://127.0.0.1:3310. Empty: only the built-in checks. Dashboard. |
REPLORA_ALERTS_PRIVATE_WEBHOOKS | empty (= only in the Single user edition) | May alert webhooks go to private or reserved addresses (localhost, 10.x, 192.168.x…). The SaaS edition never allows it by default. |
EXPERIMENTS_ALLOW_SCRIPTS | false | A/B test variants may run custom JavaScript on the customer's site. Even then only account managers may save such code. |
Billing (SaaS)
| Key | Default | What it does |
|---|---|---|
BILLING_PROVIDER | empty | stripe or paddle; empty = payments not set up. Dashboard. |
STRIPE_KEY, STRIPE_SECRET, STRIPE_WEBHOOK_SECRET | empty | Stripe publishable key, secret key and webhook signing secret (webhook: https://<your site>/stripe/webhook). All three are needed. Dashboard. |
STRIPE_WEBHOOK_TOLERANCE | 300 | Seconds a Stripe webhook timestamp may differ. |
PADDLE_API_KEY, PADDLE_CLIENT_SIDE_TOKEN, PADDLE_WEBHOOK_SECRET | empty | Paddle API key, client-side token (Paddle.js) and notification secret (webhook: /paddle/webhook). All three are needed. Dashboard. |
PADDLE_SANDBOX | false | Use Paddle's sandbox. Dashboard. |
PLANS_GRACE_DAYS | 7 | Days a plan keeps working while the payment provider retries a failed payment. |
CASHIER_CURRENCY, CASHIER_CURRENCY_LOCALE, CASHIER_PATH, other CASHIER_*, PADDLE_SELLER_ID, PADDLE_AUTH_CODE, PADDLE_RETAIN_KEY | Laravel Cashier defaults | Read by Laravel Cashier; usually left alone. |
See Billing: Stripe and Billing: Paddle.
Email
Used while the email settings in Settings › Installation are not saved (Dashboard for all of these):
| Key | Default | What it does |
|---|---|---|
MAIL_MAILER | log | smtp, sendmail, log (writes emails to the log), or another Laravel mailer. |
MAIL_HOST, MAIL_PORT, MAIL_USERNAME, MAIL_PASSWORD, MAIL_SCHEME | 127.0.0.1, 2525, empty | SMTP server. MAIL_SCHEME: smtp or smtps. |
MAIL_URL | empty | One SMTP URL instead. |
MAIL_FROM_ADDRESS, MAIL_FROM_NAME | [email protected], APP_NAME | Sender. |
MAIL_EHLO_DOMAIN, MAIL_SENDMAIL_PATH, MAIL_LOG_CHANNEL | derived | SMTP greeting, sendmail command, log channel for log. |
POSTMARK_API_KEY, POSTMARK_MESSAGE_STREAM_ID, RESEND_API_KEY, AWS_ACCESS_KEY_ID, AWS_SECRET_ACCESS_KEY, AWS_DEFAULT_REGION | empty | Keys of API mailers (Postmark, Resend, Amazon SES). |
SLACK_BOT_USER_OAUTH_TOKEN, SLACK_BOT_USER_DEFAULT_CHANNEL | empty | Laravel's Slack notifications (alerts use incoming webhooks instead). |
See Email delivery.
Other storage
| Key | Default | What it does |
|---|---|---|
FILESYSTEM_DISK | local | Laravel's default disk for other files. |
AWS_ACCESS_KEY_ID, AWS_SECRET_ACCESS_KEY, AWS_DEFAULT_REGION, AWS_BUCKET, AWS_URL, AWS_ENDPOINT, AWS_USE_PATH_STYLE_ENDPOINT | empty | Laravel's general s3 disk. Recordings use the RECORDINGS_* keys. |
Logging
| Key | Default | What it does |
|---|---|---|
LOG_CHANNEL | stack | |
LOG_STACK | single | Channels of the stack (daily keeps one file a day). |
LOG_LEVEL | debug | Lowest level written; warning or error on live servers keeps logs small. |
LOG_DAILY_DAYS | 14 | Days of daily files kept. |
LOG_DEPRECATIONS_CHANNEL, LOG_DEPRECATIONS_TRACE | null, false | PHP deprecation messages. |
LOG_SLACK_WEBHOOK_URL, LOG_SLACK_USERNAME, LOG_SLACK_EMOJI, PAPERTRAIL_URL, PAPERTRAIL_PORT, LOG_PAPERTRAIL_HANDLER, LOG_STDERR_FORMATTER, LOG_SYSLOG_FACILITY | empty | Other log targets. |
Development only
| Key | Default | What it does |
|---|---|---|
HUBSPOT_API_URL | https://api.hubapi.com | HubSpot's API address (changed only for tests). |
PHP_CLI_SERVER_WORKERS | — | Workers of php artisan serve. |
VITE_APP_NAME | ${APP_NAME} | The name the Vite dev build sees. |
A production example
dotenv
APP_NAME="Replora"
APP_ENV=production
APP_DEBUG=false
APP_URL=https://replora.example.com
APP_KEY=base64:…
REPLORA_MODE=single
DB_CONNECTION=pgsql
DB_HOST=127.0.0.1
DB_PORT=5432
DB_DATABASE=replora
DB_USERNAME=replora
DB_PASSWORD=…
CACHE_STORE=redis
SESSION_DRIVER=redis
QUEUE_CONNECTION=redis
REDIS_HOST=127.0.0.1
RECORDINGS_DRIVER=s3
RECORDINGS_BUCKET=replora-recordings
RECORDINGS_ENDPOINT=https://<account>.r2.cloudflarestorage.com
RECORDINGS_REGION=auto
RECORDINGS_KEY=…
RECORDINGS_SECRET=…
MAIL_MAILER=smtp
MAIL_HOST=smtp.example.com
MAIL_PORT=587
MAIL_USERNAME=…
MAIL_PASSWORD=…
MAIL_FROM_ADDRESS=[email protected]
ANTHROPIC_API_KEY=…
LOG_LEVEL=warningphp artisan replora:doctor checks the result for production and for several servers.
