---
title: 1-Click w/ Docker Compose
image: /images/user-guide/objects/objects.png
---

<Frame>
  <img src="/images/user-guide/objects/objects.png" alt="Header" />
</Frame>

<Warning>
Docker containers are for production hosting or self-hosting, for the contribution please check the [Local Setup](https://docs.twenty.com/l/cs/developers/local-setup).
</Warning>

## 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í](https://docs.twenty.com/l/cs/developers/self-hosting/setup) 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
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:

```bash
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:

   ```bash
   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:

   ```bash
   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:

   ```ini
   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ů.

   ```ini
   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:

```bash
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:

```bash
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](http://localhost:3000).

If you host it on a server, check that the server is running and that everything is ok with

```bash
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:

     ```ini
     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é:

     ```ini
     SERVER_URL=https://your-domain-or-ip
     ```

   - **S Reverzní Proxy (Vlastní Porty):**

     Pokud používáte nestandardní porty:

     ```ini
     SERVER_URL=https://your-domain-or-ip:custom-port
     ```

2. **Aktualizujte `.env` Soubor**

   Otevřete svůj `.env` soubor a aktualizujte `SERVER_URL`:

   ```ini
   SERVER_URL=http(s)://your-domain-or-ip:your-port
   ```

   **Příklady:**

   - Přímý přístup bez SSL:
     ```ini
     SERVER_URL=http://123.45.67.89:3000
     ```
   - Přístup přes doménu s SSL:
     ```ini
     SERVER_URL=https://mytwentyapp.com
     ```

3. **Restartujte Aplikaci**

   Pro aplikaci změn restartujte Docker kontejnery:

   ```bash
   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íží](https://docs.twenty.com/l/cs/developers/self-hosting/troubleshooting) pro možná řešení.

