Přejít na hlavní obsah
Docker kontejnery jsou určeny pro produkční hosting nebo samohostování; pro přispívání si prosím přečtěte Lokální nastavení.

​
Přehled

Tato příručka poskytuje podrobný návod k instalaci a konfiguraci aplikace Twenty pomocí Docker Compose. Cílem je zjednodušit proces a zabránit běžným úskalím, která by mohla narušit vaše nastavení. Důležité: Měňte pouze nastavení výslovně uvedená v tomto průvodci. Změna jiných konfigurací může vést k problémům. Podívejte se na dokumentaci Nastavení Proměnných Prostředí pro pokročilou konfiguraci. Všechny proměnné prostředí musí být deklarovány v souboru docker-compose.yml na úrovni serveru a/nebo pracovníka v závislosti na proměnné.

​
Systémové Požadavky

  • RAM: Ujistěte se, že vaše prostředí má alespoň 2GB RAM. Nedostatek paměti může způsobit zhroucení procesů.
  • Docker & Docker Compose: Ujistěte se, že obě jsou nainstalovány a aktuální.

​
Možnost 1: Jednořádkový skript

Nainstalujte nejnovější stabilní verzi Twenty jedním příkazem: 
bash <(curl -sL https://raw.githubusercontent.com/twentyhq/twenty/main/packages/twenty-docker/scripts/install.sh)
Pro instalaci konkrétní verze nebo větve vypište: 
VERSION=vx.y.z BRANCH=branch-name bash <(curl -sL https://raw.githubusercontent.com/twentyhq/twenty/main/packages/twenty-docker/scripts/install.sh)
  • Nahraďte x.y.z požadovaným číslem verze.
  • Nahraďte branch-name názvem větve, kterou chcete nainstalovat.

​
Možnost 2: Manuální kroky

Postupujte podle těchto kroků pro ruční nastavení.

​
Krok 1: Nastavení souboru Prostředí

  1. Vytvořte soubor .env Zkopírujte příklad souboru prostředí do nového souboru .env ve vašem pracovním adresáři: 
    curl -o .env https://raw.githubusercontent.com/twentyhq/twenty/refs/heads/main/packages/twenty-docker/.env.example
  2. Vygenerujte tajné tokeny Spusťte následující příkaz k generování jedinečného náhodného řetězce: 
    openssl rand -base64 32
    Důležité: Udržujte tuto hodnotu v tajnosti / nesdílejte ji.
  3. Aktualizujte .env soubor Nahraďte místoblokovou hodnotu ve svém .env souboru vygenerovaným tokenem: 
    APP_SECRET=první_náhodný_řetězec
  4. Nastavte Heslo pro Postgres Aktualizujte hodnotu PG_DATABASE_PASSWORD ve vašem .env souboru silným heslem bez speciálních znaků. 
    PG_DATABASE_PASSWORD=moje_silné_heslo

​
Krok 2: Získání souboru Docker Compose

Stáhněte soubor docker-compose.yml do svého pracovního adresáře: 
curl -o docker-compose.yml https://raw.githubusercontent.com/twentyhq/twenty/refs/heads/main/packages/twenty-docker/docker-compose.yml

​
Krok 3: Spuštění aplikace

Spusťte Docker kontejnery: 
docker compose up -d

​
Krok 4: Přístup k aplikaci

Pokud hostujete twentyCRM na svém vlastním počítači, otevřete svůj prohlížeč a přejděte na stránku http://localhost:3000. Pokud to hostujete na serveru, zkontrolujte, že server běží a že je vše v pořádku s 
curl http://localhost:3000

​
Konfigurace

​
Otevření Twenty pro Externí Přístup

Ve výchozím nastavení běží Twenty na localhost na portu 3000. Pro přístup přes externí doménu nebo IP adresu musíte nakonfigurovat SERVER_URL ve vašem .env souboru.

​
Porozumění SERVER_URL

  • Protokol: Použijte http nebo https v závislosti na vašem nastavení.
    • Použijte http pokud nemáte nastavené SSL.
    • Použijte https pokud máte SSL nakonfigurované.
  • Doména/IP: Toto je doménové jméno nebo IP adresa, kde je vaše aplikace přístupná.
  • Port: Uveďte číslo portu, pokud nepoužíváte výchozí porty (80 pro http, 443 pro https).

​
Požadavky na SSL

SSL (HTTPS) je potřebné pro správné fungování některých funkcí prohlížeče. I když tyto funkce mohou fungovat během místního vývoje (protože prohlížeče zacházejí s localhost jinak), správná konfigurace SSL je nutná při hostování Twenty na běžné doméně. Například rozhraní schránky může vyžadovat zabezpečený kontext - některé funkce jako tlačítka kopírování v aplikaci nemusí fungovat bez povoleného HTTPS. Důrazně doporučujeme nastavit Twenty za reverzní proxy se SSL ukončením pro optimální bezpečnost a funkčnost.

​
Konfigurace SERVER_URL

  1. Určete svou přístupovou URL
    • Bez Reverzní Proxy (Přímý Přístup): Pokud přistupujete k aplikaci přímo bez reverzní proxy: 
      SERVER_URL=http://vaše-doména-nebo-ip:3000
    • S Reverzní Proxy (Standardní Porty): Pokud používáte reverzní proxy jako Nginx nebo Traefik a máte SSL nakonfigurované: 
      SERVER_URL=https://vaše-doména-nebo-ip
    • S Reverzní Proxy (Vlastní Porty): Pokud používáte nestandardní porty: 
      SERVER_URL=https://vaše-doména-nebo-ip:vlastní-port
  2. Aktualizujte .env Soubor Otevřete svůj .env soubor a aktualizujte SERVER_URL: 
    SERVER_URL=http(s)://vaše-doména-nebo-ip:váš-port
    Příklady:
    • Přímý přístup bez SSL: 
      SERVER_URL=http://123.45.67.89:3000
    • Přístup přes doménu s SSL: 
      SERVER_URL=https://mojeaplikace.com
  3. Restartujte Aplikaci Pro aplikaci změn restartujte Docker kontejnery: 
    docker compose down
docker compose up -d

​
Úvahy

  • Konfigurace reverzního proxy: Ujistěte se, že váš reverzní proxy přesměruje požadavky na správný interní port (výchozí 3000). Nakonfigurujte terminaci SSL a všechny potřebné hlavičky.
  • Nastavení firewallu: Otevřete nezbytné porty v firewallu, aby byl umožněn externí přístup.
  • Konzistence: SERVER_URL musí odpovídat způsobu, jakým uživatelé přistupují k vaší aplikaci ve svých prohlížečích.

​
Perzistence

  • Datové svazky: Konfigurace Docker Compose používá svazky k ukládání dat pro databázi a úložiště serverů.
  • Bezstavová prostředí: Pokud nasazujete do bezstavového prostředí (např. některé cloudové služby), nakonfigurujte externí úložiště pro uchování dat.

​
Zálohování a obnovení

Pravidelné zálohy chrání vaše data v CRM před ztrátou.

​
Vytvořte zálohu databáze

docker exec twenty-postgres pg_dump -U postgres twenty > backup_$(date +%Y%m%d).sql

​
Automatizujte denní zálohy

Přidejte do svého crontabu (crontab -e): 
0 2 * * * docker exec twenty-postgres pg_dump -U postgres twenty > /backups/twenty_$(date +\%Y\%m\%d).sql

​
Obnovte ze zálohy

  1. Zastavte aplikaci:
docker compose stop twenty-server twenty-front
  1. Obnovte databázi:
docker exec -i twenty-postgres psql -U postgres twenty < backup_20240115.sql
  1. Restartujte služby:
docker compose up -d

​
Osvědčené postupy pro zálohování

  • Pravidelně testujte obnovy — ověřte, že zálohy skutečně fungují
  • Ukládejte zálohy mimo lokalitu — použijte cloudové úložiště (S3, GCS, atd.)
  • Šifrujte citlivá data — chraňte zálohy šifrováním
  • Uchovávejte více kopií — mějte denní, týdenní a měsíční zálohy

​
Řešení potíží

Pokud narazíte na jakýkoli problém, zkontrolujte sekci Řešení potíží pro možná řešení.