---
title: 1-Klick mit 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/de/developers/local-setup).
</Warning>

## Übersicht

This guide provides step-by-step instructions to install and configure the Twenty application using Docker Compose. Das Ziel ist, den Prozess übersichtlich zu gestalten und häufige Fallstricke zu vermeiden, die Ihre Einrichtung unterbrechen könnten.

**Wichtig:** Ändern Sie nur die in dieser Anleitung explizit erwähnten Einstellungen. Andere Konfigurationen zu ändern, kann zu Problemen führen.

See docs [Setup Environment Variables](https://docs.twenty.com/l/de/developers/self-hosting/setup) for advanced configuration. All environment variables must be declared in the docker-compose.yml file at the server and / or worker level depending on the variable.

## Systemanforderungen

- RAM: Stellen Sie sicher, dass Ihre Umgebung mindestens 2 GB RAM hat. Unzureichender Speicher kann dazu führen, dass Prozesse abstürzen.
- Docker & Docker Compose: Stellen Sie sicher, dass beide installiert und aktuell sind.

## Option 1: One-line script

Installieren Sie die neueste stabile Version von Twenty mit einem einzigen Befehl:

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

Um eine spezifische Version oder Zweig zu installieren:

```bash
VERSION=vx.y.z BRANCH=branch-name bash <(curl -sL https://raw.githubusercontent.com/twentyhq/twenty/main/packages/twenty-docker/scripts/install.sh)
```

- Ersetzen Sie x.y.z mit der gewünschten Versionsnummer.
- Ersetzen Sie branch-name durch den Namen des Zweigs, den Sie installieren möchten.

## Option 2: Manuelle Schritte

Follow these steps for a manual setup.

### Schritt 1: Einrichten der Umgebungsdatei

1. **Erstellen Sie die .env Datei**

   Kopieren Sie die Beispielumgebungsdatei in eine neue .env-Datei in Ihrem Arbeitsverzeichnis:

   ```bash
   curl -o .env https://raw.githubusercontent.com/twentyhq/twenty/refs/heads/main/packages/twenty-docker/.env.example
   ```

2. **Erstellen Sie geheime Tokens**

   Führen Sie den folgenden Befehl aus, um eine eindeutige Zufallszeichenfolge zu generieren:

   ```bash
   openssl rand -base64 32
   ```

   **Wichtig:** Bewahren Sie diesen Wert geheim auf / teilen Sie ihn nicht.

3. **Aktualisieren Sie die `.env`**

   Ersetzen Sie den Platzhalterwert in Ihrer .env-Datei durch das generierte Token:

   ```ini
   APP_SECRET=first_random_string
   ```

4. **Setzen Sie das Postgres-Passwort**

   Aktualisieren Sie den Wert `PG_DATABASE_PASSWORD` in der .env-Datei mit einem starken Passwort ohne Sonderzeichen.

   ```ini
   PG_DATABASE_PASSWORD=my_strong_password
   ```

### Schritt 2: Beschaffen Sie die Docker Compose-Datei

Laden Sie die `docker-compose.yml`-Datei in Ihr Arbeitsverzeichnis herunter:

```bash
curl -o docker-compose.yml https://raw.githubusercontent.com/twentyhq/twenty/refs/heads/main/packages/twenty-docker/docker-compose.yml
```

### Schritt 3: Anwendung starten

Starten Sie die Docker-Container:

```bash
docker compose up -d
```

### Step 4: Access the Application

If you host twentyCRM on your own computer, open your browser and navigate to [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
```

## Konfiguration

### Twenty für externen Zugriff freigeben

Standardmäßig läuft Twenty auf `localhost` an Port `3000`. Um über eine externe Domain oder IP-Adresse darauf zuzugreifen, müssen Sie die `SERVER_URL` in Ihrer `.env`-Datei konfigurieren.

#### Understanding `SERVER_URL`

- **Protokoll:** Verwenden Sie `http` oder `https` je nach Konfiguration.
  - Verwenden Sie `http`, wenn Sie kein SSL eingerichtet haben.
  - Verwenden Sie `https`, wenn Sie SSL konfiguriert haben.
- **Domain/IP:** Dies ist der Domainname oder die IP-Adresse, unter der Ihre Anwendung zugänglich ist.
- **Port:** Include the port number if you're not using the default ports (`80` for `http`, `443` for `https`).

### SSL-Anforderungen

SSL (HTTPS) ist erforderlich, damit bestimmte Browserfunktionen ordnungsgemäß funktionieren. Obwohl diese Funktionen möglicherweise während der lokalen Entwicklung funktionieren (da Browser localhost anders behandeln), ist eine ordnungsgemäße SSL-Einrichtung erforderlich, wenn Twenty auf einer regulären Domain gehostet wird.

Zum Beispiel erfordert die Clipboard-API möglicherweise einen sicheren Kontext - einige Funktionen wie Kopierknöpfe in der gesamten Anwendung funktionieren möglicherweise nicht ohne aktiviertes HTTPS.

Wir empfehlen dringend, Twenty hinter einem Reverse-Proxy mit SSL-Beendigung für optimale Sicherheit und Funktionalität zu konfigurieren.

#### Konfiguration der `SERVER_URL`

1. **Bestimmen Sie Ihre Zugriffs-URL**
   - **Ohne Reverse-Proxy (Direkter Zugriff):**

     Wenn Sie direkt ohne Reverse-Proxy auf die Anwendung zugreifen:

     ```ini
     SERVER_URL=http://your-domain-or-ip:3000
     ```

   - **Mit Reverse-Proxy (Standard-Ports):**

     Wenn Sie einen Reverse-Proxy wie Nginx oder Traefik verwenden und SSL konfiguriert haben:

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

   - **Mit Reverse-Proxy (Benutzerdefinierte Ports):**

     Wenn Sie nicht standardisierte Ports verwenden:

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

2. **Aktualisieren Sie die `.env` Datei**

   Öffnen Sie Ihre `.env`-Datei und aktualisieren Sie die `SERVER_URL`:

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

   **Beispiele:**

   - Direkter Zugriff ohne SSL:
     ```ini
     SERVER_URL=http://123.45.67.89:3000
     ```
   - Zugriff über Domain mit SSL:
     ```ini
     SERVER_URL=https://mytwentyapp.com
     ```

3. **Starten Sie die Anwendung neu**

   Damit die Änderungen wirksam werden, starten Sie die Docker-Container neu:

   ```bash
   docker compose down
   docker compose up -d
   ```

#### Überlegungen

- **Reverse Proxy-Konfiguration:**

  Stellen Sie sicher, dass Ihr Reverse-Proxy Anfragen an den richtigen internen Port weiterleitet (`3000` standardmäßig). Configure SSL termination and any necessary headers.

- **Firewall-Einstellungen:**

  Öffnen Sie die notwendigen Ports in Ihrer Firewall, um externen Zugriff zu ermöglichen.

- **Konsistenz:**

  Die `SERVER_URL` muss mit der Art und Weise übereinstimmen, wie Nutzer in ihren Browsern auf Ihre Anwendung zugreifen.

#### Persistenz

- **Data Volumes:**

  The Docker Compose configuration uses volumes to persist data for the database and server storage.

- **Zustandslose Umgebungen:**

  If deploying to a stateless environment (e.g., certain cloud services), configure external storage to persist data.

## Fehlerbehebung

Sollten Sie auf ein Problem stoßen, schauen Sie sich die [Fehlerbehebung](https://docs.twenty.com/l/de/developers/self-hosting/troubleshooting) für Lösungen an.