Programme als Container installieren

Mach dich mit dem Bearbeiten der docker-compose.yml vertraut. Diese findest du unter /home/[user]/ei23-docker/docker-compose.yml.

Ich habe dazu ein ausführliches Video:

Bearbeitung

Für die Bearbeitung gibt es mehrere Möglichkeiten:

Templates

Es liegen Templates, also "Installationsschablonen," zum nachträglichen Installieren in /home/[user]/ei23-docker/compose_templates bereit. Du kannst sie benutzen und entsprechend in die docker-compose.yml kopieren.

Verfügbare Templates

Die Templates befinden sich im Ordner ei23-docker/compose_templates/. Hier einige Beispiele:

Template einfügen

1. Öffne die docker-compose.yml
2. Füge den Inhalt des Templates am Ende der Datei ein
3. Achte auf korrekte Einrückung (YAML ist empfindlich!)
4. Speichere die Datei
5. Führe ei23 dc aus

Template anwenden

Nach der Anpassung der docker-compose.yml führe aus:

ei23 dc

Oder über das Dashboard: Server-Seite → "Docker Compose" Button.

Docker Compose verstehen

Ports

Das Routing für Docker funktioniert wie die Portfreigabe an einem Router:

ports:
  - HOST_PORT:CONTAINER_PORT

• HOST_PORT: Externer Port am Server erreichbar
• CONTAINER_PORT: Interner Port im Container

Beispiel:

  image: nginx:1.24.0
  ports:
    - 8080:80

Hier ist 8080 der externe Port (am Server) und 80 der interne Port (im Container).

Volumes

Volumes binden Ordner des Host-Systems in den Container ein:

volumes:
  - HOST_PFAD:CONTAINER_PFAD

Beispiel:

volumes:
  - ./volumes/nginx:/etc/nginx/templates

• ./volumes/nginx - Ordner auf dem Host (relativ zum docker-compose.yml)
• /etc/nginx/templates - Pfad im Container

Devices

Devices binden Hardware in den Container ein:

devices:
  - /dev/video0:/dev/video0

Wichtig für: - Zigbee-Sticks (/dev/ttyUSB0) - Kameras (/dev/video0) - GPIO (Raspberry Pi)

Environment Variables

Umgebungsvariablen konfigurieren den Container:

environment:
  - TZ=Europe/Berlin
  - MYSQL_PASSWORD=password_placeholder

Networks

Netzwerke verbinden Container miteinander:

networks:
  - default
  - custom_network

# Am Ende der docker-compose.yml definieren:
networks:
  custom_network:
    driver: bridge
    internal: true

Depends_on

Definiert Start-Reihenfolge:

depends_on:
  - database
  - redis

Restart Policy

Steuert das Neustart-Verhalten:

restart: unless-stopped  # Immer neu starten, außer manuell gestoppt
restart: always          # Immer neu starten
restart: on-failure      # Nur bei Fehler
restart: "no"            # Nie neustarten

Architektur-Hinweise

Je nach Architektur (armv7/arm64/amd64) kann es vorkommen, dass es kein aktuelles Image des Containers gibt. Dies kann man beispielsweise unter hub.docker.com nachschauen.

Beispiel: Älteres Image nutzen

  image: nginx:1.24.0

Hier wurde :1.24.0 angehängt um eine bestimmte Version zu nutzen.

Port-Konflikte

Wenn ein Port bereits belegt ist, ändere den Host-Port:

# Vorher (Port 8080 belegt)
ports:
  - 8080:80

# Nachher (Port 8081 nutzen)
ports:
  - 8081:80

Beispiel: Komplette docker-compose.yml

services:
  homeassistant:
    image: ghcr.io/home-assistant/home-assistant:stable
    container_name: homeassistant
    restart: unless-stopped
    network_mode: host
    volumes:
      - ./volumes/homeassistant/config:/config
      - /run/dbus:/run/dbus:ro
    environment:
      - TZ=Europe/Berlin

  mosquitto:
    image: eclipse-mosquitto:2
    container_name: mosquitto
    restart: unless-stopped
    ports:
      - "1883:1883"
    volumes:
      - ./volumes/mosquitto/config:/mosquitto/config
      - ./volumes/mosquitto/data:/mosquitto/data
      - ./volumes/mosquitto/log:/mosquitto/log

  grafana:
    image: grafana/grafana:latest
    container_name: grafana
    restart: unless-stopped
    ports:
      - "3000:3000"
    volumes:
      - ./volumes/grafana:/var/lib/grafana
    environment:
      - GF_SECURITY_ADMIN_USER=admin
      - GF_SECURITY_ADMIN_PASSWORD=password_placeholder

# Netzwerke (falls benötigt)
# networks:
#   my_network:
#     driver: bridge

Fehlerbehebung

Container startet nicht

# Logs prüfen
docker compose logs [container_name]

# Container manuell starten
docker compose up -d [container_name]

Port belegt

# Prüfe welcher Port belegt ist
sudo netstat -tulpn | grep [PORT]

# Oder
sudo ss -tulpn | grep [PORT]

YAML-Syntax Fehler

# YAML validieren
python3 -c "import yaml; yaml.safe_load(open('docker-compose.yml'))"

Container zurücksetzen

# Einfach über das Skript
ei23 fullreset [container_name]

# Manuell
cd ~/ei23-docker/
docker compose stop [container_name]
docker compose rm -f [container_name]
sudo rm -r volumes/[container_name]/
docker compose up -d

Weitere Informationen

• Docker Compose Dokumentation
• Docker Hub - Images suchen
• ei23 Dashboard - Template-Übersicht