Skip to content

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.

ReferenceAdministrators, DevOpsSingle user · SaaS

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 ​

KeyDefaultWhat it does
REPLORA_MODEsinglesingle (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_PATHsaasFolder of the SaaS modules and pages, relative to the app folder.
REPLORA_SIGNUPtrueSaaS: self-service sign-up open. Dashboard.
REPLORA_INSTALLEDfalsetrue treats the app as installed without the marker file (development, tests).
REPLORA_INSTALL_MARKERapp/replora-installed.jsonThe 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 ​

KeyDefaultWhat it does
APP_NAMEReploraProduct name in page titles and emails. Dashboard.
APP_ENVproductionproduction 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_KEYSemptyOld keys, comma separated, still accepted for decryption while you rotate APP_KEY.
APP_DEBUGfalseNever true on a public server (shows error details).
APP_URLhttp://localhostThe 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_LOCALEenDefault interface language (en es fr de pt it ru zh ja ko tr id ar). Dashboard.
APP_FALLBACK_LOCALEenLanguage used when a text is missing.
APP_FAKER_LOCALEen_USTest data only.
APP_MAINTENANCE_DRIVER, APP_MAINTENANCE_STOREfile, databaseWhere Laravel keeps the maintenance flag (cache with a shared store on several servers).
SANCTUM_STATEFUL_DOMAINSlocalhost addresses plus APP_URL's hostHosts (with port) where the dashboard's session sign-in works, comma separated. The installer writes it from the site address.
SANCTUM_TOKEN_PREFIXemptyPrefix for new API tokens (helps secret scanners recognise them).
REPLORA_DESIGNclassicThe dashboard's design for everyone: classic, daylight, midnight, compact, soft or contrast. Dashboard.
REPLORA_APP_RETURN_URLSemptyComma-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_ROUNDS12Password hashing cost.
AUTH_GUARD, AUTH_MODEL, AUTH_PASSWORD_BROKER, AUTH_PASSWORD_RESET_TOKEN_TABLE, AUTH_PASSWORD_TIMEOUTLaravel defaultsLaravel authentication internals; leave them.

Database ​

Replora uses PostgreSQL (the installer writes DB_CONNECTION=pgsql).

KeyDefaultWhat it does
DB_CONNECTIONsqlite (installer: pgsql)pgsql.
DB_HOST127.0.0.1Database server.
DB_PORT5432
DB_DATABASElaravelDatabase name.
DB_USERNAMEroot
DB_PASSWORDempty
DB_URLemptyOne connection URL instead of the keys above.
DB_CHARSETutf8
DB_SSLMODEpreferPostgreSQL SSL mode (require, verify-full …) for managed databases.
DB_SOCKET, DB_COLLATION, DB_FOREIGN_KEYS, DB_ENCRYPT, DB_TRUST_SERVER_CERTIFICATE, MYSQL_ATTR_SSL_CALaravel defaultsUsed by other drivers only.

Cache, sessions and queue ​

KeyDefaultWhat it does
CACHE_STOREdatabase (installer: file)file, database or redis. Use redis or database on several servers.
CACHE_PREFIXfrom APP_NAMEKey prefix in a shared cache.
DB_CACHE_CONNECTION, DB_CACHE_TABLE, DB_CACHE_LOCK_CONNECTION, DB_CACHE_LOCK_TABLE, CACHE_STORAGE_DISK, CACHE_STORAGE_PATHLaravel defaultsDetails of the database and file stores.
MEMCACHED_HOST, MEMCACHED_PORT, MEMCACHED_USERNAME, MEMCACHED_PASSWORD, MEMCACHED_PERSISTENT_ID, DYNAMODB_CACHE_TABLE, DYNAMODB_ENDPOINTLaravel defaultsOther cache drivers.
SESSION_DRIVERdatabase (installer: file)file, database or redis. Not file on several servers.
SESSION_LIFETIME120Minutes of inactivity before signing out (unless "remember me").
SESSION_ENCRYPTfalseEncrypt session data.
SESSION_SECURE_COOKIEautomatictrue 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_TABLELaravel defaultsCookie and storage details.
QUEUE_CONNECTIONdatabasedatabase, redis, or sync (no worker: recordings are processed during the request; only for small sites).
QUEUE_FAILED_DRIVERdatabase-uuidsWhere 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_SUFFIXLaravel defaultsQueue driver details.

Redis ​

KeyDefault
REDIS_CLIENTphpredis
REDIS_HOST, REDIS_PORT, REDIS_USERNAME, REDIS_PASSWORD127.0.0.1, 6379, empty, empty
REDIS_URLempty (one URL instead)
REDIS_DB, REDIS_CACHE_DB0, 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_TIMEOUTLaravel defaults

Recordings ​

KeyDefaultWhat it does
RECORDINGS_DRIVERlocallocal (storage/app/recordings) or s3 (Amazon S3, Cloudflare R2, MinIO and other S3-compatible storage).
RECORDINGS_BUCKETrecordingsS3 bucket.
RECORDINGS_ENDPOINTemptyS3 endpoint, e.g. https://<account>.r2.cloudflarestorage.com or http://127.0.0.1:9000 (path-style addresses are used).
RECORDINGS_KEY, RECORDINGS_SECRETemptyS3 access key and secret.
RECORDINGS_REGIONus-east-1S3 region (auto for R2).
RECORDINGS_DEFAULT_RETENTION_DAYS30Retention of new websites (7, 30, 90, 180 or 365). Dashboard.
RECORDINGS_INGEST_QUEUEdefaultingest 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_MINUTE600Tracker requests (batches and rules) accepted per minute from one IP address. A visitor sends about 12 a minute. Dashboard.
RECORDINGS_CACHE_STYLESHEETStrueKeep copies of the stylesheets recorded pages link to, so replays keep their look.
RECORDINGS_STYLESHEETS_ALLOW_PRIVATEempty (= 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_SITEemptyThe 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_DAYS1Days the demo's recordings are kept. Dashboard.
REPLORA_PLAYER_THEMEclassicThe replay player's control bar: classic, minimal, cinema, glass, capsule or studio. Dashboard.

See Recording storage and Scaling to high traffic.

Live updates ​

KeyDefaultWhat it does
REPLORA_REALTIMEpollingpolling (HTTP, no extra server) or websocket (Laravel Reverb; set BROADCAST_CONNECTION=reverb and the REVERB_* keys, run php artisan reverb:start).
REPLORA_POLL_SECONDS5Polling interval (at least 2).
BROADCAST_CONNECTIONnullreverb for WebSockets.
REVERB_APP_ID, REVERB_APP_KEY, REVERB_APP_SECRETemptyThe Reverb app's credentials (your own values).
REVERB_HOST, REVERB_PORT, REVERB_SCHEMEempty, 443, httpsWhere browsers connect.
REVERB_SERVER_HOST, REVERB_SERVER_PORT, REVERB_SERVER_PATH0.0.0.0, 8080, emptyWhere the Reverb server listens.
REVERB_SCALING_ENABLED, REVERB_SCALING_CHANNELfalse, reverbShare 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_INTERVALReverb defaultsReverb tuning.
PUSHER_APP_ID, PUSHER_APP_KEY, PUSHER_APP_SECRET, PUSHER_APP_CLUSTER, PUSHER_HOST, PUSHER_PORT, PUSHER_SCHEME, ABLY_KEY, MERCURE_*emptyOther broadcasters Laravel supports; Replora's live view uses Reverb or polling.

AI (Claude) ​

KeyDefaultWhat it does
ANTHROPIC_API_KEYemptyThe Anthropic API key. Without it AI summaries, plain-words search, Ask AI and site digests say they aren't set up. Dashboard.
REPLORA_AI_MODELclaude-opus-5-5The Claude model. Dashboard.
REPLORA_AI_EFFORTlowHow much the model thinks for summaries. Dashboard.
REPLORA_ASSISTANT_EFFORTmediumHow much the model thinks for Ask AI. Dashboard.
REPLORA_HELP_AItrueThe help center answers questions with AI (needs the key). Dashboard.
REPLORA_HELP_CONTACT_URLemptyWhere "Contact us" in the help widget leads (an address or mailto:); empty hides it. Dashboard.

See AI features.

Licensing and updates ​

KeyDefaultWhat it does
REPLORA_LICENSE_URLhttps://altara.digital/api/verify-purchaseThe license server purchase codes are checked with.
REPLORA_LICENSE_REQUIREDtruefalse (bundled review builds) lets the installer go on without a purchase code; the System page then asks for one.
REPLORA_LICENSE_FILEstorage/app/replora-license.jsonWhere the verified purchase code is kept.
REPLORA_UPDATE_FEEDset by releasesThe release manifest URL for one-click updates.
REPLORA_UPDATE_KEYset by releasesThe 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 ​

KeyDefaultWhat it does
RECAPTCHA_OFFfalsetrue switches reCAPTCHA off from the server when a wrong key locks everyone out (the keys stay). Same as php artisan replora:recaptcha off.
REPLORA_CLAMAVemptyA 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_WEBHOOKSempty (= 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_SCRIPTSfalseA/B test variants may run custom JavaScript on the customer's site. Even then only account managers may save such code.

Billing (SaaS) ​

KeyDefaultWhat it does
BILLING_PROVIDERemptystripe or paddle; empty = payments not set up. Dashboard.
STRIPE_KEY, STRIPE_SECRET, STRIPE_WEBHOOK_SECRETemptyStripe publishable key, secret key and webhook signing secret (webhook: https://<your site>/stripe/webhook). All three are needed. Dashboard.
STRIPE_WEBHOOK_TOLERANCE300Seconds a Stripe webhook timestamp may differ.
PADDLE_API_KEY, PADDLE_CLIENT_SIDE_TOKEN, PADDLE_WEBHOOK_SECRETemptyPaddle API key, client-side token (Paddle.js) and notification secret (webhook: /paddle/webhook). All three are needed. Dashboard.
PADDLE_SANDBOXfalseUse Paddle's sandbox. Dashboard.
PLANS_GRACE_DAYS7Days 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_KEYLaravel Cashier defaultsRead 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):

KeyDefaultWhat it does
MAIL_MAILERlogsmtp, sendmail, log (writes emails to the log), or another Laravel mailer.
MAIL_HOST, MAIL_PORT, MAIL_USERNAME, MAIL_PASSWORD, MAIL_SCHEME127.0.0.1, 2525, emptySMTP server. MAIL_SCHEME: smtp or smtps.
MAIL_URLemptyOne SMTP URL instead.
MAIL_FROM_ADDRESS, MAIL_FROM_NAME[email protected], APP_NAMESender.
MAIL_EHLO_DOMAIN, MAIL_SENDMAIL_PATH, MAIL_LOG_CHANNELderivedSMTP 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_REGIONemptyKeys of API mailers (Postmark, Resend, Amazon SES).
SLACK_BOT_USER_OAUTH_TOKEN, SLACK_BOT_USER_DEFAULT_CHANNELemptyLaravel's Slack notifications (alerts use incoming webhooks instead).

See Email delivery.

Other storage ​

KeyDefaultWhat it does
FILESYSTEM_DISKlocalLaravel'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_ENDPOINTemptyLaravel's general s3 disk. Recordings use the RECORDINGS_* keys.

Logging ​

KeyDefaultWhat it does
LOG_CHANNELstack
LOG_STACKsingleChannels of the stack (daily keeps one file a day).
LOG_LEVELdebugLowest level written; warning or error on live servers keeps logs small.
LOG_DAILY_DAYS14Days of daily files kept.
LOG_DEPRECATIONS_CHANNEL, LOG_DEPRECATIONS_TRACEnull, falsePHP deprecation messages.
LOG_SLACK_WEBHOOK_URL, LOG_SLACK_USERNAME, LOG_SLACK_EMOJI, PAPERTRAIL_URL, PAPERTRAIL_PORT, LOG_PAPERTRAIL_HANDLER, LOG_STDERR_FORMATTER, LOG_SYSLOG_FACILITYemptyOther log targets.

Development only ​

KeyDefaultWhat it does
HUBSPOT_API_URLhttps://api.hubapi.comHubSpot'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=warning

php artisan replora:doctor checks the result for production and for several servers.

Replora: see what your visitors see.