1 „Läuft bei mir, aber nicht bei dir"

Software braucht eine bestimmte Umgebung: die richtige Sprach-Version, Bibliotheken, Systempakete, Konfiguration. Fehlt auf dem Zielrechner etwas, läuft es nicht — oder schlimmer: anders.

2 Container vs. virtuelle Maschine

3 Was du davon hast

1 Der Zeitstrahl

Container sind keine Erfindung von Docker — Docker hat sie nur für alle einfach gemacht.

2 Engine, Desktop & Registries

Images leben in einer Registry: öffentlich auf Docker Hub oder GHCR (GitHub), oder in einer eigenen, self-gehosteten. docker pull lädt herunter, docker push lädt hoch — wie bei Git, nur für Images.

1 Image, Container & Layer

Das wichtigste Begriffspaar: ein Image ist die unveränderliche Vorlage, ein Container die laufende Instanz davon.

2 Die Schlüsselbegriffe

• Image — die Vorlage (gestapelte Layer). Hat einen Tag, z. B. postgres:16 (Name:Version).
• Container — eine laufende Instanz eines Images; bekommt einen Namen (--name).
• Registry — der „App-Store" für Images (Docker Hub, GHCR, eigene) — pull/push.
• Volume — persistenter Speicher außerhalb des Containers (Stufe 5). Ohne ihn sind Daten beim Löschen weg.
• Port-Mapping — -p 5678:5678 verbindet einen Host-Port mit einem Container-Port.
• Netzwerk — Container im selben Netz erreichen sich über ihren Namen (wichtig für Compose, Stufe 6).

3 Der Lebenszyklus eines Containers

Vier Stationen — vom Image zum laufenden Container und wieder weg.

1 Docker installieren

Wähle oben deine Plattform — die Schritte passen sich an.

Versionsstand: Docker Engine / Desktop v27 · Stand Juni 2026. Die hier gezeigten Befehle sind seit Jahren stabil.

2 Den ersten echten Dienst starten: n8n

Genug Theorie — wir starten unseren roten Faden. Ein Befehl, und n8n läuft.

• -d — „detached": läuft im Hintergrund, gibt das Terminal frei.
• --name n8n — ein merkbarer Name statt einer zufälligen ID.
• -p 5678:5678 — Host-Port 5678 → Container-Port 5678.

3 Container im Griff: die Grundbefehle

docker ps                 # laufende Container (mit -a: auch gestoppte)
docker logs -f n8n        # Live-Logs ansehen
docker exec -it n8n sh    # eine Shell IM Container öffnen
docker stop n8n          # anhalten
docker start n8n         # wieder starten
docker rm -f n8n         # entfernen (erzwingt Stop)
docker images            # geladene Images

4 Claude Code kennt die Befehle

Du musst dir die Flags nicht merken — beschreibe einfach, was du willst.

1 Warum Daten verschwinden

Alles, was ein Container schreibt, lebt in seiner dünnen, beschreibbaren Schicht — und die stirbt mit dem Container.

2 Named Volume vs. Bind-Mount

Zwei Wege, Daten persistent zu machen — beide über -v.

n8n persistent starten:

3 Umgebung & Ports konfigurieren

• -e KEY=wert — Umgebungsvariablen (Zeitzone, DB-Zugang, Feature-Flags). Die übliche Art, einen Container zu konfigurieren.
• -p 8080:80 — Host-Port 8080 zeigt auf Container-Port 80. Links Host, rechts Container.
• --restart unless-stopped — Container startet nach einem Reboot automatisch wieder (wichtig für Server, Stufe 8).

1 Vom langen run zur compose.yml

n8n soll seine Daten in eine richtige Datenbank schreiben? Dann brauchst du zwei Container, die zusammenspielen. Statt zweier langer docker run-Befehle: eine Datei.

services:
  postgres:
    image: postgres:16
    restart: unless-stopped
    environment:
      POSTGRES_DB: n8n
      POSTGRES_USER: n8n
      POSTGRES_PASSWORD: changeme     # Platzhalter!
    volumes: [ "pg_data:/var/lib/postgresql/data" ]
  n8n:
    image: docker.n8n.io/n8nio/n8n
    restart: unless-stopped
    depends_on: [ postgres ]
    ports: [ "5678:5678" ]
    environment:
      DB_TYPE: postgresdb
      DB_POSTGRESDB_HOST: postgres        # = Service-Name!
      DB_POSTGRESDB_PASSWORD: changeme
    volumes: [ "n8n_data:/home/node/.n8n" ]
volumes:
  pg_data:
  n8n_data:

2 Der Stack als Bild

3 Den Stack bedienen

docker compose up -d      # alle Services im Hintergrund starten
docker compose ps         # Status des Stacks
docker compose logs -f    # Logs aller Services live
docker compose down       # stoppen & entfernen (Volumes bleiben!)

1 Fertiges Image nutzen oder selbst bauen?

Die meiste Zeit nimmst du fertige Images (n8n, Postgres, nginx …). Ein eigenes Image baust du für deinen eigenen Code.

2 Das Dockerfile

Ein Dockerfile ist ein Rezept: Basis-Image wählen, eigene Dateien hineinkopieren, Startbefehl setzen. Beispiel: eine statische Website (z. B. die aus der Web-Schulung) in ein winziges nginx-Image packen.

FROM nginx:alpine                  # schlankes Basis-Image
COPY ./site /usr/share/nginx/html   # deine Dateien hinein
# nginx startet automatisch — kein CMD nötig

3 Tags, .dockerignore & wann neu bauen

• Tag — versioniere dein Image: docker build -t meine-site:1.2 .. latest ist nur ein bewegliches Etikett.
• .dockerignore — wie .gitignore: hält node_modules, .git und Secrets aus dem Image (kleiner & sicherer).
• Neu bauen nach jeder Code-Änderung. In der compose.yml bindest du es per build: . statt image: ein.

1 Den Stack auf den Server bringen

Auf einem VPS ist Docker dasselbe wie lokal — nur per SSH. Du legst die compose.yml aus Stufe 6 in einen Ordner und startest sie.

2 Reverse Proxy: HTTPS & Domain

Niemand soll :5678 tippen. Ein Reverse Proxy nimmt Anfragen auf n8n.deinedomain.de entgegen, kümmert sich um HTTPS und reicht sie an den Container weiter.

n8n.deinedomain.de {
    reverse_proxy localhost:5678
}

3 Betrieb: Updates & Backups

Zwei Handgriffe, die du regelmäßig brauchst.

docker compose pull        # neue Images holen
docker compose up -d       # Container mit neuen Images neu erstellen

docker run --rm -v n8n_data:/data -v $PWD:/backup busybox \
  tar czf /backup/n8n-backup.tgz /data

1 Sichere Defaults

Die meisten Sicherheitsprobleme entstehen aus wenigen, vermeidbaren Fehlern. Diese vier Regeln decken das Wichtigste ab:

2 Secrets via .env & Aufräumen

Statt Passwörter in die compose.yml zu schreiben, legst du sie in eine .env daneben (die nicht ins Git-Repo gehört):

POSTGRES_PASSWORD=ein-langes-zufälliges-passwort
N8N_ENCRYPTION_KEY=…

3 Claude Code als Docker-Helfer

Compose-Dateien, Dockerfiles, kryptische Fehler — beschreibe das Problem, statt zu googeln.

▶ Container-Alltag

🧩 Compose & Images

★ Gute Gewohnheiten

• Alles, was bleiben soll, in ein Volume — Container sind wegwerfbar.
• Secrets in eine .env, nie ins Image; .dockerignore früh pflegen.
• Feste Image-Tags (z. B. postgres:16) statt blind latest.
• Nach außen nur, was nötig ist — Datenbanken hinter dem Reverse Proxy lassen.