Portainer Housekeeping

Dieser Artikel beschreibt die regelmäßige Wartung und Fehleranalyse für Portainer. Ziel: Tote Endpoints vermeiden, Logs im Griff behalten, Plattenplatz sichern und stabile Funktion sicherstellen.

Portainer verwaltet Umgebungen („Environments“) → jede zeigt auf einen Docker-Socket oder eine Remote-API.

• Menü: Environments
• Prüfen, ob „Local“ vorhanden ist:
  • Typ: Local
  • Endpoint: `unix:///var/run/docker.sock`
• Tote Einträge (z. B. alte Hosts mit IP:2376) → löschen oder deaktivieren
• Tipp: sprechende Namen vergeben („docker-mash“, „cluster-node1“)

# Test: Local Docker-Socket erreichbar?
curl --unix-socket /var/run/docker.sock http://localhost/_ping
# OK → pong

In `docker-compose.yml` für Portainer muss enthalten sein:

volumes:
  - /var/run/docker.sock:/var/run/docker.sock
  - portainer_data:/data

→ ohne diesen Mount funktioniert „Local environment“ nicht.

Portainer pingt die Environments regelmäßig (Container-Snapshot, Healthcheck).

• Menü: Settings → Snapshots
• Intervalle anpassen (z. B. 5–15 min statt 1 min)
• Snapshot für inaktive/tote Environments deaktivieren

Vollgelaufene Container-Logs führen zu „Platte 100 %“ und Fehlermeldungen.

Im Compose jedes Dienstes:

logging:
  driver: json-file
  options:
    max-size: "50m"
    max-file: "5"

lsof +L1 | head -n 20

→ zeigt Prozesse mit „gelöschten, aber noch offenen“ Dateien.

df -h /var/lib/docker /var/run
df -i /var/lib/docker        # Inodes
docker system df
docker system df -v

• „Failed to find local environment“

→ Local Socket nicht gemountet / falsche Rechte / Environment gelöscht

• „connect: connection refused 193.197.168.21:2376“

→ Remote Docker-API down oder Host nicht erreichbar

• „no route to host“

→ Firewall/VPN/Netzwerkproblem

• „cannot find webhook by containerId“

→ Container entfernt, DB-Eintrag verwaist → Stack neu deployen

Regelmäßig:

# unbenutzte Images, Container, Netzwerke, Volumes
docker system prune -af --volumes

* Vorher prüfen: Achtung löscht auch gestoppte Container und nicht genutzte Volumes.

• Portainer selbst hinter Traefik/HTTPS betreiben
• Zugriff nur aus internen Netzen oder via VPN
• Admin-Account mit 2FA absichern

• Persistente Daten liegen in `portainer_data`
• Backup reicht: Volume oder `/opt/stacks/portainer/` + Daten sichern
• Restore: neues Portainer-Container mit altem Volume starten

1. [ ] Ist die Platte voll? (`df -h`)
2. [ ] Sind alte Environments noch eingetragen?
3. [ ] Ist der Docker-Socket gemountet?
4. [ ] Funktioniert `curl –unix-socket … _ping`?
5. [ ] Snapshot-Intervall zu klein?
6. [ ] Offene gelöschte Logs (`lsof +L1`)?