Kompletní přehled proměnných prostředí (.env reference)

Níže naleznete přehled proměnných prostředí, které lze v LockMyCal konfigurovat. Nepovinné proměnné mají rozumné výchozí hodnoty – nastavujte jen to, co potřebujete.

Important

Od verze 1.15.7 se hodnoty v .env čtou doslova: ${VAR} ani $(příkaz) se nerozbalí a znak #, před kterým není mezera, je součástí hodnoty.

1. Základní nastavení aplikace

Proměnná	Výchozí hodnota	Popis
`SECRET_KEY_BASE`	(povinné)	Tajný klíč pro podepisování sessions a cookies (`openssl rand -base64 64`).
`DATA_ENCRYPTION_KEY`	(doporučené)	Klíč pro šifrování přístupových údajů v databázi (`openssl rand -base64 48`).
`PHX_HOST`	(povinné)	Veřejná doména instance (např. `rezervace.vasedomena.cz`).
`PORT`	`4000`	Port, na kterém aplikace naslouchá.
`URL_SCHEME`	`https`	`http` jen pro lokální či interní nasazení bez TLS.
`WS_ALLOWED_ORIGINS`	(z `PHX_HOST`)	Povolené originy pro WebSocket, pokud aplikace běží na více hostnamech.
`REGISTRATION_ENABLED`	`true`	Povolení registrace nových uživatelů (platí i pro SSO).
`PASSWORD_AUTH_ENABLED`	`true`	Přihlašování e-mailem a heslem; `false` ponechá jen SSO.
`WEB_HOST`	(nepovinné)	Veřejná adresa webu s dokumentací (např. `https://lockmycal.com`; jen schéma a host, bez lomítka a cesty) – liší se od `PHX_HOST`. Z ní vznikají odkazy do dokumentace, ikona webu v horních lištách dashboardu a rezervačních stránek a odkaz Nahlásit chybu v patičce (`<WEB_HOST>/forum/bugs`). Bez ní se ikona ani odkaz nezobrazují.
`SOURCE_CODE_URL`	`https://github.com/lockmycal/lockmycal`	Veřejný repozitář se zdrojovým kódem běžící verze (AGPL ho vyžaduje nabídnout všem, kdo instanci používají přes síť). Odkazuje na něj postranní panel dashboardu a e-maily s upozorněním správci (stránka `/issues`). Provozujete-li upravenou verzi, nasměrujte ho na vlastní repozitář.

2. Databáze PostgreSQL

Proměnná	Výchozí hodnota	Popis
`POSTGRES_PASSWORD`	(povinné)	Heslo k databázi.
`POSTGRES_USER` / `POSTGRES_DB`	–	Uživatel a název databáze.
`DATABASE_URL`	–	Kompletní připojovací řetězec (alternativa k jednotlivým proměnným).
`DATABASE_HOST` / `DATABASE_PORT`	– / `5432`	Adresa a port databázového serveru.
`DATABASE_SSL`	–	Šifrované spojení s databází (`true`); respektuje i `sslmode` v `DATABASE_URL`.
`DATABASE_POOL_SIZE`	`10`	Velikost fondu databázových spojení.

3. E-mail

Proměnná	Popis
`EMAIL_ADAPTER`	`smtp` / `postmark` / `sendgrid` / `mailgun` / `ahasend`
`EMAIL_FROM_ADDRESS` / `EMAIL_FROM_NAME`	Odesílací adresa a jméno odesílatele.
`EMAIL_SUPPORT_ADDRESS`	Kontaktní adresa podpory v e-mailech (výchozí `EMAIL_FROM_ADDRESS`).
`SMTP_HOST` / `SMTP_PORT` / `SMTP_USERNAME` / `SMTP_PASSWORD`	Připojení k SMTP serveru (šifrování se odvozuje z portu).
`SMTP_SSL`	Vynutí implicitní TLS i na jiném portu než 465.
`SMTP_TLS_VERIFY`	Ověřování certifikátu serveru: `peer` (výchozí) / `none`.
`SMTP_TLS_MIDDLEBOX_COMPAT`	`true` jen pro relay za zařízením, které blokuje TLS 1.3.
`POSTMARK_API_KEY`	Server API token Postmarku.
`SENDGRID_API_KEY`	API klíč SendGrid.
`MAILGUN_API_KEY` / `MAILGUN_DOMAIN` / `MAILGUN_BASE_URL`	Nastavení Mailgunu.
`AHASEND_API_KEY` / `AHASEND_ACCOUNT_ID`	Nastavení AhaSend.

4. Kalendáře, video a OAuth

Proměnná	Popis
`GOOGLE_CLIENT_ID` / `GOOGLE_CLIENT_SECRET` / `GOOGLE_STATE_SECRET`	Google Calendar, Google Meet a přihlášení účtem Google.
`OUTLOOK_CLIENT_ID` / `OUTLOOK_CLIENT_SECRET` / `OUTLOOK_STATE_SECRET`	Outlook, Microsoft Teams a přihlášení účtem Microsoft.
`ZOOM_CLIENT_ID` / `ZOOM_CLIENT_SECRET` / `ZOOM_STATE_SECRET` / `ZOOM_DEAUTH_SECRET`	Aplikace Zoom.
`ZOOM_UPDATE_SCOPE_ENABLED`	`false`, pokud aplikace Zoom nemá oprávnění `meeting:update:meeting`.
`WEBHOOK_BASE_URL`	Veřejná HTTPS adresa pro push notifikace Google/Outlook (bez ní se synchronizuje pravidelně, ne v reálném čase).
`ALLOW_PRIVATE_IPS_FOR_CALENDAR` / `ALLOW_PRIVATE_IPS_FOR_VIDEO`	Povolí kalendářové a video servery na interních adresách.
`VIDEO_ROOM_RETENTION_DAYS`	Po kolika dnech od konce schůzky se smažou video místnosti (výchozí `7`).

5. Přihlašování (SSO)

Proměnná	Popis
`ENABLE_GOOGLE_AUTH` / `ENABLE_GITHUB_AUTH` / `ENABLE_MICROSOFT_AUTH`	Přihlašování účtem Google, GitHub a Microsoft (lze zapnout i v administraci).
`GITHUB_CLIENT_ID` / `GITHUB_CLIENT_SECRET`	Aplikace GitHub OAuth.
`ENABLE_OAUTH_AUTH`	Obecné OAuth 2.0 / OIDC přihlášení.
`OAUTH_CLIENT_ID` / `OAUTH_CLIENT_SECRET`	Klient ve vašem poskytovateli identity.
`OAUTH_AUTHORIZE_URL` / `OAUTH_TOKEN_URL` / `OAUTH_USERINFO_URL`	Endpointy poskytovatele (HTTPS).
`OAUTH_PROVIDER_URL` / `OAUTH_SCOPE` / `OAUTH_EMAIL_VERIFIED_CLAIM` / `OAUTH_ALLOW_ID_FALLBACK`	Další volby – viz Generic SSO.

6. Ochrana před boty

Proměnná	Výchozí hodnota	Popis
`RECAPTCHA_SIGNUP_PROVIDER` / `RECAPTCHA_BOOKING_PROVIDER`	`off`	Poskytovatel pro registraci a pro rezervace: `off` / `google` / `cloudflare`.
`RECAPTCHA_SITE_KEY` / `RECAPTCHA_SECRET_KEY`	–	Klíče Google reCAPTCHA v3.
`RECAPTCHA_SIGNUP_MIN_SCORE` / `RECAPTCHA_BOOKING_MIN_SCORE`	`0.3`	Prahové skóre reCAPTCHA (0.0 až 1.0).
`TURNSTILE_SITE_KEY` / `TURNSTILE_SECRET_KEY`	–	Klíče Cloudflare Turnstile.
`RECAPTCHA_SIGNUP_ENABLED` / `RECAPTCHA_BOOKING_ENABLED`	`false`	Starší varianta (odpovídá poskytovateli `google`).

7. Síť a proxy

Proměnná	Popis
`HTTP_PROXY` / `HTTPS_PROXY` / `NO_PROXY`	Odchozí proxy pro korporátní sítě.
`TRUST_PRIVATE_CLIENT_IPS`	`true` jen pro instanci dostupnou výhradně z interní sítě, kde mají návštěvníci privátní adresy.
`ALLOW_PRIVATE_IPS_FOR_WEBHOOKS`	Povolí odesílání webhooků na interní adresy.

8. Notifikace a upozornění

Proměnná	Popis
`TELEGRAM_ENABLED`	Režim vlastních botů uživatelů.
`TELEGRAM_BOT_TOKEN` / `TELEGRAM_BOT_USERNAME` / `TELEGRAM_WEBHOOK_SECRET`	Režim jednoho sdíleného bota instance.
`SLACK_ENABLED`	Slack přes Incoming Webhook.
`SLACK_CLIENT_ID` / `SLACK_CLIENT_SECRET`	Slack přes OAuth (tlačítko Add to Slack).
`ADMIN_ALERTS_ENABLED` / `ADMIN_ALERT_EMAIL`	E-mailová upozornění administrátorovi na chyby a problémy integrací (včetně nových chyb ze sledování chyb).

9. Platby

Proměnná	Popis
`MEETING_PAYMENTS_ENABLED`	Zapnutí plateb za schůzky.
`STRIPE_SECRET_KEY` / `STRIPE_WEBHOOK_SECRET` / `STRIPE_CONNECT_WEBHOOK_SECRET`	Stripe API a webhooky.
`MEETING_PAYMENTS_DEFAULT_COUNTRY`	Výchozí země nových Stripe účtů organizátorů.
`MEETING_PAYMENTS_APPLICATION_FEE_BP`	Poplatek platformy v bazických bodech (100 = 1 %), výchozí `0`.

10. Analytika, audit a logy

Proměnná	Popis
`UMAMI_SCRIPT_URL` / `UMAMI_WEBSITE_ID`	Měření návštěvnosti přes Umami.
`ANALYTICS_SALT_SECRET`	Tajný klíč pro anonymizaci návštěvníků v analytice – vygenerujte jednou a neměňte.
`ERROR_TRACKING_ENABLED`	Ukládání chyb, pádů a neúspěšných úloh do databáze aplikace (výchozí `true`; hodnoty `true`/`false`, `1`/`0`, `yes`/`no`, `on`/`off`). Nic se neposílá třetím stranám. Podrobnosti v Konzoli administrátora.
`AUDIT_LOG_RETENTION_DAYS`	Jak dlouho uchovávat bezpečnostní auditní log (výchozí 90 dní).
`LOG_FILE_PATH` / `LOG_FILE_MAX_BYTES` / `LOG_FILE_MAX_FILES`	Zápis logu do rotovaného souboru.