> ## Documentation Index > Fetch the complete documentation index at: https://docs.twenty.com/llms.txt > Use this file to discover all available pages before exploring further. # Nastavení # Správa konfigurace **Instalujete poprvé?** Postupujte podle [průvodce instalací Docker Compose](/l/cs/developers/self-host/capabilities/docker-compose) k rozchození Twenty, a poté se sem vraťte pro konfiguraci. Twenty nabízí **dvě konfigurační režimy** pro různé potřeby nasazení: **Přístup k administračnímu panelu:** Pouze uživatelé s administrátorskými právy (`canAccessFullAdminPanel: true`) mohou přistupovat k rozhraní pro konfiguraci. ## 1. Konfigurace Admin panelu (výchozí) ```bash theme={null} IS_CONFIG_VARIABLES_IN_DB_ENABLED=true # default ``` **Většina konfigurace probíhá prostřednictvím uživatelského rozhraní** po instalaci: 1. Přistupte ke své instanci Twenty (obvykle `http://localhost:3000`) 2. Jděte na **Nastavení / Admin panel / Konfigurační proměnné** 3. Nakonfigurujte integrace, e-mail, úložiště a další 4. Změny se projeví okamžitě (u nasazení s více kontejnery do 15 sekund) **Nasazení s více kontejnery:** Při použití databázové konfigurace (`IS_CONFIG_VARIABLES_IN_DB_ENABLED=true`) čtou oba serverové i pracovní kontejnery ze stejné databáze. Změny v administračním panelu se dotýkají obou automaticky, což eliminuje potřebu duplicitních proměnných prostředí mezi kontejnery (s výjimkou infrastrukturních proměnných). **Co můžete konfigurovat přes administrační panel:** * **Autentizace** - Google/Microsoft OAuth, nastavení hesla * **E-mail** - nastavení SMTP, šablony, ověření * **Úložiště** - konfigurace S3, místní cesty k úložišti * **Integrace** - Gmail, Google Kalendář, služby Microsoft * **Pracovní postup & Omezení rychlosti** - limity provádění, škrcení API * **A ještě mnohem více...** Proměnné konfigurace Admin panelu Každá proměnná je dokumentována s popisy ve vašem administračním panelu v sekci **Nastavení → Admin panel → Konfigurační proměnné**. Některá nastavení infrastruktury, jako připojení k databázi (`PG_DATABASE_URL`), URL serveru (`SERVER_URL`) a tajné klíče (`ENCRYPTION_KEY`, `FALLBACK_ENCRYPTION_KEY`), lze konfigurovat pouze prostřednictvím souboru `.env`. [Kompletní technická referenční příručka →](https://github.com/twentyhq/twenty/blob/main/packages/twenty-server/src/engine/core-modules/twenty-config/config-variables.ts) ## Šifrovací klíče Twenty používá dva šifrovací klíče dostupné pouze přes proměnné prostředí: | Proměnná | Účel | Povinné | | ------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ | ------------------------------------------------------------------------------------------------- | | `ENCRYPTION_KEY` | Primární klíč používaný k šifrování tajných hodnot „v klidu“ (tokeny OAuth, aplikační proměnné, privátní klíče podepisovacích klíčů, TOTP tajné kódy, citlivé konfigurační hodnoty). | Ano pro nové instalace (starší instalace se mohou místo toho spoléhat na `APP_SECRET` — viz níže) | | `FALLBACK_ENCRYPTION_KEY` | Klíč používaný pouze k ověřování. Během rotace se nastavuje na *předchozí* hodnotu `ENCRYPTION_KEY`, aby bylo možné dešifrovat stávající řádky. | Pouze během rotace | Kvůli zpětné kompatibilitě, pokud `ENCRYPTION_KEY` není nastaven, Twenty používá pro šifrování „v klidu“ záložně `APP_SECRET`, což odpovídá původnímu chování starších nasazení. Nové instalace by vždy měly nastavit dedikovaný `ENCRYPTION_KEY`. Hodnoty vygenerujte pomocí `openssl rand -base64 32` a uložte je na bezpečné místo (správce tajných klíčů, zapečetěná konfigurace apod.). Ztráta `ENCRYPTION_KEY` znamená ztrátu přístupu ke všem tajným hodnotám uloženým v databázi. Jak provést rotaci `ENCRYPTION_KEY` bez výpadku, najdete v [průvodci rotací klíče](/l/cs/developers/self-host/capabilities/key-rotation). ## 2. Konfigurace pouze přes prostředí ```bash theme={null} IS_CONFIG_VARIABLES_IN_DB_ENABLED=false ``` **Všechna konfigurace je spravována prostřednictvím souborů `.env`:** 1. Nastavte `IS_CONFIG_VARIABLES_IN_DB_ENABLED=false` ve vašem souboru `.env` 2. Přidejte všechny konfigurační proměnné do souboru `.env` 3. Restartujte kontejnery, aby se změny projevily 4. Administrační panel zobrazí aktuální hodnoty, ale nemůže je upravovat ## Režim více pracovních prostorů Ve výchozím nastavení běží Twenty v **režimu jednoho pracovního prostoru** — ideální pro většinu samostatně hostovaných nasazení, kde potřebujete jednu instanci CRM pro svou organizaci. ### Režim jednoho pracovního prostoru (výchozí) ```bash theme={null} IS_MULTIWORKSPACE_ENABLED=false # default ``` * Jeden pracovní prostor na instanci Twenty * První uživatel se automaticky stává administrátorem s plnými oprávněními (`canImpersonate` a `canAccessFullAdminPanel`) * Po vytvoření prvního pracovního prostoru jsou nové registrace zakázány. * Jednoduchá struktura URL: `https://your-domain.com` ### Povolení režimu více pracovních prostorů ```bash theme={null} IS_MULTIWORKSPACE_ENABLED=true DEFAULT_SUBDOMAIN=app # default value ``` Povolte režim více pracovních prostorů pro nasazení typu SaaS, kde více nezávislých týmů potřebuje své vlastní pracovní prostory na téže instanci Twenty. **Klíčové rozdíly oproti režimu jednoho pracovního prostoru:** * Na téže instanci lze vytvářet více pracovních prostorů * Každý pracovní prostor získá vlastní subdoménu (např. `sales.your-domain.com`, `marketing.your-domain.com`) * Uživatelé se registrují a přihlašují na `{DEFAULT_SUBDOMAIN}.your-domain.com` (např. `app.your-domain.com`) * Žádná automatická administrátorská oprávnění — první uživatel v každém pracovním prostoru je běžný uživatel * Nastavení specifická pro pracovní prostor, jako je subdoména a vlastní doména, se zpřístupní v nastavení pracovního prostoru **Nastavení pouze na úrovni prostředí:** `IS_MULTIWORKSPACE_ENABLED` lze konfigurovat pouze prostřednictvím souboru `.env` a vyžaduje restart. Nelze jej změnit prostřednictvím administračního panelu. ### Konfigurace DNS pro více pracovních prostorů Při použití režimu více pracovních prostorů nakonfigurujte své DNS pomocí zástupného (wildcard) záznamu, aby bylo možné dynamicky vytvářet subdomény: ``` *.your-domain.com -> your-server-ip ``` Tím se umožní automatické směrování subdomén pro nové pracovní prostory bez ruční konfigurace DNS. ### Omezení vytváření pracovních prostorů V režimu více pracovních prostorů možná budete chtít omezit, kdo může vytvářet nové pracovní prostory: ```bash theme={null} IS_WORKSPACE_CREATION_LIMITED_TO_SERVER_ADMINS=true ``` Pokud je povoleno, pouze uživatelé s `canAccessFullAdminPanel` mohou vytvářet další pracovní prostory. Uživatelé si stále mohou při úvodní registraci vytvořit svůj první pracovní prostor. ## Integrace Gmail & Google Kalendář ### Vytvořte projekt Google Cloud 1. Přejděte na [Google Cloud Console](https://console.cloud.google.com/) 2. Vytvořte nový projekt nebo vyberte existující 3. Povolte tyto API: * [Gmail API](https://console.cloud.google.com/apis/library/gmail.googleapis.com) * [Google Calendar API](https://console.cloud.google.com/apis/library/calendar-json.googleapis.com) * [People API](https://console.cloud.google.com/apis/library/people.googleapis.com) ### Konfigurace OAuth 1. Přejděte na [Pověření](https://console.cloud.google.com/apis/credentials) 2. Vytvořte OAuth 2.0 Client ID 3. Přidejte tyto URI přesměrování: * `https://{your-domain}/auth/google/redirect` (pro SSO) * `https://{your-domain}/auth/google-apis/get-access-token` (pro integrace) ### Konfigurace v Twenty 1. Jděte na **Nastavení → Admin panel → Konfigurační proměnné** 2. Najděte sekci **Google Auth** 3. Nastavte tyto proměnné: * `MESSAGING_PROVIDER_GMAIL_ENABLED=true` * `CALENDAR_PROVIDER_GOOGLE_ENABLED=true` * `AUTH_GOOGLE_CLIENT_ID={client-id}` * `AUTH_GOOGLE_CLIENT_SECRET={client-secret}` * `AUTH_GOOGLE_CALLBACK_URL=https://{your-domain}/auth/google/redirect` * `AUTH_GOOGLE_APIS_CALLBACK_URL=https://{your-domain}/auth/google-apis/get-access-token` **Režim pouze s prostředím:** Pokud nastavíte `IS_CONFIG_VARIABLES_IN_DB_ENABLED=false`, přidejte tyto proměnné do souboru `.env` **Požadované rozsahy** (automaticky konfigurované): [Zobrazit relevantní zdrojový kód](https://github.com/twentyhq/twenty/blob/main/packages/twenty-server/src/engine/core-modules/auth/utils/get-google-apis-oauth-scopes.ts#L4-L10) * `https://www.googleapis.com/auth/calendar.events` * `https://www.googleapis.com/auth/gmail.readonly` * `https://www.googleapis.com/auth/profile.emails.read` ### Pokud je vaše aplikace v testovacím režimu Pokud je vaše aplikace v testovacím režimu, budete muset přidat testovací uživatele do vašeho projektu. V části [Obrazovka souhlasu s OAuth](https://console.cloud.google.com/apis/credentials/consent) přidejte své testovací uživatele do sekce "Testovací uživatelé". ## Integrace Microsoft 365 Uživatelé musí mít [Licence Microsoft 365](https://admin.microsoft.com/Adminportal/Home), aby mohli používat API Kalendáře a Zpráv. Bez něj nebudou moci synchronizovat svůj účet na Twenty. ### Vytvořte projekt v Microsoft Azure Budete muset vytvořit projekt v [Microsoft Azure](https://portal.azure.com/#view/Microsoft_AAD_IAM/AppGalleryBladeV2) a získat pověření. ### Povoleňte API Na konzoli Microsoft Azure povolte následující API v "Povoleních": * Microsoft Graph: Mail.ReadWrite * Microsoft Graph: Mail.Send * Microsoft Graph: Calendars.Read * Microsoft Graph: User.Read * Microsoft Graph: openid * Microsoft Graph: email * Microsoft Graph: profile * Microsoft Graph: offline\_access Poznámka: "Mail.ReadWrite" a "Mail.Send" jsou povinné pouze v případě, že chcete odesílat e-maily pomocí našich pracovních postupů. Můžete použít "Mail.Read" místo toho, pokud chcete pouze přijímat e-maily. ### Autorizované URI přesměrování Musíte přidat následující URI přesměrování do vašeho projektu: * `https://{your-domain}/auth/microsoft/redirect`, pokud chcete použít Microsoft SSO * `https://{your-domain}/auth/microsoft-apis/get-access-token` ### Konfigurace v Twenty 1. Jděte na **Nastavení → Admin panel → Konfigurační proměnné** 2. Najděte sekci **Microsoft Auth** 3. Nastavte tyto proměnné: * `MESSAGING_PROVIDER_MICROSOFT_ENABLED=true` * `CALENDAR_PROVIDER_MICROSOFT_ENABLED=true` * `AUTH_MICROSOFT_ENABLED=true` * `AUTH_MICROSOFT_CLIENT_ID={client-id}` * `AUTH_MICROSOFT_CLIENT_SECRET={client-secret}` * `AUTH_MICROSOFT_CALLBACK_URL=https://{your-domain}/auth/microsoft/redirect` * `AUTH_MICROSOFT_APIS_CALLBACK_URL=https://{your-domain}/auth/microsoft-apis/get-access-token` **Režim pouze s prostředím:** Pokud nastavíte `IS_CONFIG_VARIABLES_IN_DB_ENABLED=false`, přidejte tyto proměnné do souboru `.env` ### Konfigurace rozsahů [Zobrazit relevantní zdrojový kód](https://github.com/twentyhq/twenty/blob/main/packages/twenty-server/src/engine/core-modules/auth/utils/get-microsoft-apis-oauth-scopes.ts#L2-L9) * 'openid' * 'email' * 'profil' * 'offline\_access' * 'Mail.ReadWrite' * 'Mail.Send' * 'Calendars.Read' ### Pokud je vaše aplikace v testovacím režimu Pokud je vaše aplikace v testovacím režimu, budete muset přidat testovací uživatele do vašeho projektu. Přidejte své testovací uživatele do sekce "Uživatelé a skupiny". ## Pracovní úkoly pro Kalendář & Zprávy Po konfiguraci integrací Gmail, Google Kalendář nebo Microsoft 365 je třeba spustit úlohy na synchronizaci dat na pozadí. Zaregistrujte následující opakující se úlohy ve vašem pracovním kontejneru: ```bash theme={null} # from your worker container yarn command:prod cron:messaging:messages-import yarn command:prod cron:messaging:message-list-fetch yarn command:prod cron:calendar:calendar-event-list-fetch yarn command:prod cron:calendar:calendar-events-import yarn command:prod cron:messaging:ongoing-stale yarn command:prod cron:calendar:ongoing-stale yarn command:prod cron:workflow:automated-cron-trigger ``` ## Konfigurace Emailu 1. Jděte na **Nastavení → Admin panel → Konfigurační proměnné** 2. Najděte sekci **E-mail** 3. Nakonfigurujte své nastavení SMTP: Budete potřebovat zřídit [Heslo aplikace](https://support.google.com/accounts/answer/185833). * EMAIL\_DRIVER=smtp * EMAIL\_SMTP\_HOST=smtp.gmail.com * EMAIL\_SMTP\_PORT=465 * EMAIL\_SMTP\_USER=gmail\_email\_address * EMAIL\_SMTP\_PASSWORD='gmail\_app\_password' **smtp4dev** je falešný SMTP e-mailový server pro vývoj a testování. * EMAIL\_DRIVER=smtp * EMAIL\_SMTP\_HOST=smtp.office365.com * EMAIL\_SMTP\_PORT=587 * EMAIL\_SMTP\_USER=office365\_email\_address * EMAIL\_SMTP\_PASSWORD='office365\_password' **smtp4dev** je falešný SMTP e-mailový server pro vývoj a testování. * Spusťte obraz smtp4dev: `docker run --rm -it -p 8090:80 -p 2525:25 rnwood/smtp4dev` * Přístup k uživatelskému rozhraní smtp4dev zde: [http://localhost:8090](http://localhost:8090) * Nastavte následující proměnné: * EMAIL\_DRIVER=smtp * EMAIL\_SMTP\_HOST=localhost * EMAIL\_SMTP\_PORT=2525 **Režim pouze s prostředím:** Pokud nastavíte `IS_CONFIG_VARIABLES_IN_DB_ENABLED=false`, přidejte tyto proměnné do souboru `.env` ## Úložiště S3 Ve výchozím nastavení Twenty ukládá nahrané soubory do místního souborového systému. Pro produkční nasazení použijte S3 nebo službu kompatibilní se S3 (MinIO, DigitalOcean Spaces atd.). aby byly soubory zachovány při restartech kontejnerů a bylo možné škálovat napříč více instancemi serveru. Nastavte `STORAGE_TYPE=S_3` a nakonfigurujte proměnné `STORAGE_S3_*` prostřednictvím administračního panelu nebo `.env`. Viz [referenci config-variables.ts](https://github.com/twentyhq/twenty/blob/main/packages/twenty-server/src/engine/core-modules/twenty-config/config-variables.ts) pro úplný seznam proměnných S3. Při používání S3 s funkcemi závislými na CORS (např. stahování souborů v prohlížeči) se ujistěte, že váš bucket povoluje origin vašeho frontendu Twenty ve své konfiguraci CORS. ## Logické funkce a interpret kódu Twenty podporuje logické funkce pro pracovní postupy a interpret kódu pro analýzu dat s využitím AI. Obě spouštějí kód poskytnutý uživatelem a z důvodu zabezpečení vyžadují explicitní konfiguraci. ### Výchozí nastavení zabezpečení **V produkci (NODE\_ENV=production):** Jak logické funkce, tak interpret kódu mají ve výchozím nastavení stav **Zakázáno**. Pokud tyto funkce potřebujete, musíte je explicitně povolit pomocí `LOGIC_FUNCTION_TYPE` a `CODE_INTERPRETER_TYPE`. **V prostředí vývoje (NODE\_ENV=development):** Obě mají ve výchozím nastavení **LOCAL** pro pohodlí při lokálním spuštění. **Upozornění na zabezpečení:** Místní ovladač (`LOGIC_FUNCTION_TYPE=LOCAL` nebo `CODE_INTERPRETER_TYPE=LOCAL`) spouští kód přímo na hostiteli v procesu Node.js bez sandboxu. Měl by být používán pouze pro důvěryhodný kód při vývoji. Pro produkční nasazení, která pracují s nedůvěryhodným kódem, použijte `LOGIC_FUNCTION_TYPE=LAMBDA` nebo `CODE_INTERPRETER_TYPE=E2B` (se sandboxem), případně je ponechte vypnuté. ### Logické funkce - dostupné ovladače | Ovladač | Proměnná prostředí | Případ použití | Úroveň zabezpečení | | --------- | ------------------------------ | ------------------------------------------ | ----------------------------------- | | Neaktivní | `LOGIC_FUNCTION_TYPE=DISABLED` | Úplně zakázat logické funkce | N/A | | Lokální | `LOGIC_FUNCTION_TYPE=LOCAL` | Vývojová a důvěryhodná prostředí | Nízká (bez sandboxu) | | Lambda | `LOGIC_FUNCTION_TYPE=LAMBDA` | Produkční prostředí s nedůvěryhodným kódem | Vysoká (izolace na úrovni hardwaru) | ### Logické funkce - doporučená konfigurace **Pro vývoj:** ```bash theme={null} LOGIC_FUNCTION_TYPE=LOCAL # default when NODE_ENV=development ``` **Pro produkci (AWS):** ```bash theme={null} LOGIC_FUNCTION_TYPE=LAMBDA LOGIC_FUNCTION_LAMBDA_REGION=us-east-1 LOGIC_FUNCTION_LAMBDA_ROLE=arn:aws:iam::123456789:role/your-lambda-role LOGIC_FUNCTION_LAMBDA_ACCESS_KEY_ID=your-access-key LOGIC_FUNCTION_LAMBDA_SECRET_ACCESS_KEY=your-secret-key ``` **Pro zakázání logických funkcí:** ```bash theme={null} LOGIC_FUNCTION_TYPE=DISABLED # default when NODE_ENV=production ``` ### Interpret kódu - dostupné ovladače | Ovladač | Proměnná prostředí | Případ použití | Úroveň zabezpečení | | --------- | -------------------------------- | ----------------------------------------------- | -------------------------- | | Neaktivní | `CODE_INTERPRETER_TYPE=DISABLED` | Zakázat spouštění kódu AI | N/A | | Lokální | `CODE_INTERPRETER_TYPE=LOCAL` | Pouze pro vývoj | Nízká (bez sandboxu) | | E2B | `CODE_INTERPRETER_TYPE=E_2_B` | Produkční prostředí se sandboxovaným spouštěním | Vysoká (izolovaný sandbox) | Při použití `LOGIC_FUNCTION_TYPE=DISABLED` nebo `CODE_INTERPRETER_TYPE=DISABLED` vrátí každý pokus o spuštění chybu. To je užitečné, pokud chcete provozovat Twenty bez těchto schopností.