Přejít na hlavní obsah
Header
Docker containers are for production hosting or self-hosting, for the contribution please check the Local Setup.

​
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. Generate Secret Tokens 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=first_random_string
  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=my_strong_password

​
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. If you host it on a server, check that the server is running and that everything is ok with 
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://your-domain-or-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://your-domain-or-ip
    • S Reverzní Proxy (Vlastní Porty): Pokud používáte nestandardní porty: 
      SERVER_URL=https://your-domain-or-ip:custom-port
  2. Aktualizujte .env Soubor Otevřete svůj .env soubor a aktualizujte SERVER_URL: 
    SERVER_URL=http(s)://your-domain-or-ip:your-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://mytwentyapp.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). Configure SSL termination and any necessary headers.
  • 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.

​
Řešení potíží

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