Skip to content

Installation settings ​

The Installation tab of Settings holds everything about the installation as a whole: your logo and favicon, the company behind the service, the dashboard design, the product name and language, email delivery, sign-in with Google, spam protection, virus scanning, recordings, the replay player, the AI key, the help center and — on SaaS — sign-up, payments, trials, affiliates, support tickets and the public website's texts. Each card saves on its own, and what you save here wins over the server's .env file.

12 minutesInstallation administratorsSingle user · SaaS

Where: user menu or sidebar › Settings, tab Installation (/settings#installation). The tab exists only for administrators. The other tabs, General (language, time zone, appearance) and Account (name, email, password, two-factor, data), are each person's own: see Account settings.

your-domain.com/settings#installationInteractive: click the numbers
1. Installation tabOnly administrators have it. The address keeps the tab (#installation), so it survives a reload and can be linked.

How these settings work ​

  • One card, one Save. Every card has its own Save button (the two design cards have Apply). A toast says Settings saved.
  • Stored in the database, over .env. Values are kept in the database and applied over the configuration when the app starts. The .env file stays the fallback: a field you never saved shows the .env value (or the built-in default).
  • Secrets are never shown. Password and key fields show Saved when a value is stored, with •••••••• in the box. Leave it empty to keep the stored value, type to replace it, or press Remove (Removed when you save) to delete it. Secrets are encrypted with the app key.
  • Fields that depend on others appear only when needed (for example the SMTP fields only for SMTP server).
  • Checked before saving. Numbers have a minimum and maximum, texts a maximum length (500 characters unless noted), and the server refuses anything else with a message on the field. Saving is limited to 20 times a minute.

The cards appear in the order below. Cards of modules you don't have aren't shown; SaaS-only cards are marked.

Logo and favicon ​

Your own pictures instead of the built-in mark: in the sidebar, on the sign-in page and in browser tabs. PNG, JPEG or WebP up to 2 MB; SVG is not accepted for safety.

PictureUseAdvice
LogoReplaces the mark and the product name, on light backgroundsWide, e.g. 400 × 80 px, transparent background
Logo for dark modeOptional: the dark sidebar (always dark) and dark mode; without it the logo above is usedA light version
FaviconBrowser tabs, bookmarks, home screens, the collapsed sidebarSquare, at least 192 × 192 px
Favicon for dark modeOptional: browsers in dark mode and the dark sidebar; without it the favicon above is used

Each row shows a preview on the background it's for (Built-in when none), Upload and, once uploaded, a remove button. Pictures must be 16 to 4000 px on each side; the server draws them again (which drops anything but the picture) and refuses SVG, which can carry scripts. The page reloads after a change so every place shows it. More in Appearance & branding.

Company details ​

Who runs this service. The legal pages of your public website (terms, privacy, refunds) are filled with these details, and visitors can write to the contact email.

FieldLimitsDefaultUse
Company name200 characters, one lineemptyThe legal name, e.g. "Acme Ltd".
Country100 characters, one lineemptyWhere the company is registered; the terms are governed by its laws.
Address400 characters, several linesempty
Contact emaila valid email, 255 charactersemptyFor customers, legal questions and refund requests; the pricing page's "Talk to us" writes here.
Refund window (days)0–36514How long after their first payment customers can ask for a full refund. 0 = no refunds.

These details matter mostly for the SaaS edition's public website (Website pages & SEO).

your-domain.com/settings#installation
Company details and the Dashboard design card.Company details and the Dashboard design card.
Company details and the Dashboard design card.

Dashboard design ​

The look of the dashboard for everyone. You decide whether each person may choose light or dark mode and a colour.

Six designs, each shown as a live preview in your own mode and colour: Classic (default), Daylight, Midnight, Compact, Soft, Contrast. Click one and press Apply; it applies to everyone at once (Design applied for everyone.). The one in use is marked In use.

Under the previews, the switch Let people choose light or dark mode and a colour (default on) saves at once. Off: everyone sees the dashboard in light mode with the design's colour, and Appearance disappears from their settings. Details of both: Appearance & branding.

General ​

FieldDefaultWhat it does
Product nameReplora (APP_NAME)Shown in the dashboard, emails and the public website. Up to 60 characters.
Default languageEnglish (APP_LOCALE)For emails and for people who haven't chosen a language. One of the 13 languages: English, Español, Français, Deutsch, Português, Italiano, Русский, 中文, 日本語, 한국어, Türkçe, Bahasa Indonesia, العربية.
your-domain.com/settings#installation
The General and Email delivery cards.The General and Email delivery cards.
The General and Email delivery cards.

Email delivery ​

How the app sends emails: invitations, password resets, alerts and reports. Fields: Send with (SMTP server, Mailgun, SendGrid, this server's sendmail, or Don't send (write to the log) — the default), then the fields of the chosen service, From address and From name, and the Send a test email button. Every field, its default and the emails Replora sends: Email delivery.

Sign in with Google ​

Lets people sign in with their Google account. Create an OAuth client (type "Web application") in the Google Cloud console under APIs & Services → Credentials, and add this authorized redirect URI: — the card shows your exact redirect address.

FieldDefaultWhat it does
Show "Continue with Google"offShows the Google button on the sign-in page. Works only with both the client ID and the client secret.
Client IDemptyEnds with .apps.googleusercontent.com. Up to 200 characters.
Client secret—Secret.
Let Google create new accountsonWhile sign-up is open. Off: only people who already have an account can use Google.

Set it up:

  1. In the Google Cloud console, open APIs & Services › Credentials › Create credentials › OAuth client ID, type Web application.
  2. Add the redirect URI shown on the card under Authorized redirect URIs.
  3. Copy the Client ID and Client secret into the card, switch on Show "Continue with Google", Save.

People can also connect or disconnect Google under Settings › Account.

Spam protection (reCAPTCHA) ​

Google reCAPTCHA v3 checks invisibly that sign-ups, sign-ins, password resets and contact messages come from people. Create keys of type "Score based (v3)" at google.com/recaptcha/admin with this domain: {your host}.

FieldDefaultWhat it does
Check that visitors are peopleoffWorks only with both keys.
Site keyemptyUp to 100 characters.
Secret key—Secret.
StrictnessBalanced (0.5, recommended)Google scores each visit from 0 (a bot) to 1 (a person). Stricter stops more bots but now and then a person too. Relaxed (0.3), Balanced (0.5, recommended), Strict (0.7).

Locked out?

If a wrong key ever stops everyone signing in, run php artisan replora:recaptcha off on the server.

Virus scanning of uploads ​

Uploaded files are always checked for macros, scripts in PDFs and programs in archives. With a ClamAV scanner (install clamav-daemon on the server, or run its Docker image), every attachment, document and proof is also scanned for viruses; while the scanner can't be reached, uploads are refused.

FieldDefaultWhat it does
ClamAV addressempty (REPLORA_CLAMAV)For example unix:///run/clamav/clamd.ctl or tcp://127.0.0.1:3310. Empty: no virus scanning. Up to 200 characters.

See Security & privacy › Uploaded files.

Recordings ​

FieldDefaultLimitsWhat it does
Default retention (days)30 (RECORDINGS_DEFAULT_RETENTION_DAYS)1–3650How long new sites keep recordings unless a plan says otherwise.
Uploads per minute per visitor address600 (RECORDINGS_INGEST_PER_MINUTE)60–100 000Protects the server from floods; raise it behind a shared proxy. (Many visitors behind one company proxy share one address.)
Public demo: keep recordings (days)11–30, requiredDemo visits are deleted every night once they are older than this.
Public demo: site numberempty1 or moreThe site that records the /demo page (its domain must be this server). Empty = no demo page. With a demo site, a Try live demo button appears in the top bar.
Copy stylesheets from private addressesOnly in the single-user editionOnly for a site's own domains. Whether replays may copy CSS from private network addresses (e.g. an intranet): Only in the single-user edition, Allow, Never.

Replay player ​

The look of the controls under every replay, for everyone (shared links too). Six styles shown as previews: Classic (default), Minimal, Cinema, Glass, Capsule, Studio. Pick one and press Apply (Player theme applied for everyone.).

AI (Claude) ​

Session summaries, questions, AI search, Ask AI and site summaries are answered by Claude. Each answer is billed to this key.

FieldDefaultWhat it does
Anthropic API key— (ANTHROPIC_API_KEY)From console.anthropic.com. Empty = the AI features are off. Secret.
ModelClaude Opus 5.5Claude Opus 5.5, Claude Sonnet 5.5 or Claude Haiku 5.5.
Effort for summariesLowLow / Medium / High. More effort: better answers, slower and dearer. Also used for session questions, AI search and the help chat.
Effort for Ask AIMediumLow / Medium / High. Also used for site summaries.

What each feature does and sends: AI features (Claude).

Help center ​

The help button on every dashboard page: articles you write under Administration → Help center, and a chat.

FieldDefaultWhat it does
Answer questions with AIonClaude answers from your help articles. Needs the Anthropic API key (AI card).
"Contact us" linkemptyAn address or mailto:… shown in the help widget. Empty hides it. Up to 300 characters.

See Help center.

Slow requests ​

Calls of your sites to their servers (fetch and XHR) that take at least this long are listed under Errors › Slow requests, with the sessions to watch. Applies to calls recorded from now on.

FieldDefaultLimits
Slow from (milliseconds)3000200–60 000, required

Sign-up SaaS ​

FieldDefaultWhat it does
Let people create their own accounton (REPLORA_SIGNUP)Off: accounts are created by invitation only.

See Sign-up & accounts.

Payments, Stripe, Paddle and Free trial SaaS ​

CardFieldDefaultNotes
PaymentsPayment providerNone (plans are assigned by administrators) (BILLING_PROVIDER)None, Stripe or Paddle. Takes effect for new requests right away; the provider's keys are set in its own card.
StripePublishable keyemptyStarts with pk_.
Secret key—Starts with sk_. Secret.
Webhook signing secret—Starts with whsec_. The card shows the webhook address (/stripe/webhook).
PaddleSandbox (test payments)off (PADDLE_SANDBOX)Test payments in Paddle's sandbox.
API key—Secret.
Client-side tokenempty
Notification secret key—Secret.
Free trialOffer a free trialoffNew accounts that sign up themselves try a paid plan for free, once.
Trial length (days)141–90
Plan triedChoose a planOnly paid plans can be tried.

Step by step: Billing: Stripe, Billing: Paddle, Plans & limits.

Affiliate program SaaS ​

FieldDefaultLimits
Open the affiliate programoff
Commission (%)251–90
Paid for (months)120–120; 0 = as long as the account pays
Link remembered for (days)601–365
Holding period (days)300–120; commissions become due this long after the payment
Payout currencyUSDUSD, EUR, GBP, CAD, AUD, CHF, JPY, INR, BRL
Smallest payout500–100 000

See Affiliate program.

Support tickets and Response times SaaS ​

CardFieldDefaultLimits
Support ticketsCustomers can open ticketson
Close answered tickets after (days)70–90; 0 = never
Files per message51–10
Largest file (MB)101–50
Also email new tickets toemptyaddresses separated by commas, 500 characters
Response timesTrack response timeson
Urgent / High / Normal / Low (hours)4 / 8 / 24 / 720–720 each
Remind before the deadline (minutes)605–1440
Count business hours onlyoff
Working daysMonday to FridayMonday to Friday, Monday to Saturday, Sunday to Thursday, Every day
Opens at / Closes at09:00 / 18:00full hours
Time zoneUTCany time zone

See Support desk.

Website texts: Home page headline (120 characters), Home page introduction (400), Footer text (300), Copyright line (160, default © {year} {app}), Enterprise heading (pricing) (120), Enterprise introduction (pricing) (300). Empty fields use the built-in text, translated into every language; {app} is replaced by the product name and {year} by the current year. Your own texts can get a wording per language on Translations (area Website).

Social links: one web address each for X, Facebook, LinkedIn, Instagram, YouTube, GitHub, TikTok, Discord (300 characters). They appear as icons in the website's footer; empty hides a network.

See Public website.

Settings that stay in .env ​

Some settings are only in the server's .env file, because they are needed before the database or must not be changed from a browser: the database, APP_KEY, APP_URL, the edition (REPLORA_MODE), the queue and cache drivers, recording storage (S3/R2/MinIO), live updates (REPLORA_REALTIME), the release feed and key. See Environment (.env).

Replora: see what your visitors see.