Docker Compose

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.

​

Přehled

​

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

bash <(curl -sL https://raw.githubusercontent.com/twentyhq/twenty/main/packages/twenty-docker/scripts/install.sh)

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

​

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

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

docker compose up -d

​

Krok 4: Přístup k aplikaci

curl http://localhost:3000

​

Konfigurace

​

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

​

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

​

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í

​

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

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

2. Obnovte databázi:

docker exec -i twenty-postgres psql -U postgres twenty < backup_20240115.sql

3. 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íží