Assistent · Docker

Portainer-Fehlerdiagnose

Wähle, was du beobachtest — der Assistent zeigt, was du in welcher Reihenfolge prüfst, welcher Befehl das zeigt und wie du das Ergebnis liest. Die Ursachen sind bewusst als Hypothesen formuliert: Welche zutrifft, entscheidet erst die Prüfung auf deinem System. Ausgeführt wird nichts.

Weboberfläche nicht erreichbar

Der Browser lädt https://<server>:9443 nicht — Zeitüberschreitung oder „Verbindung abgelehnt“.

Prüfe in dieser Reihenfolge

01Läuft der Portainer-Container?
```
sudo docker ps -a --filter name=portainer
```
Zeigt den Container auch dann, wenn er beendet ist, samt Status und Ports.
- Status „Up …“ → Container läuft, weiter mit der Portprüfung.
- „Exited (…)“ oder „Restarting“ → weiter im Fall „Container startet nicht“.
- Keine Zeile → Container existiert nicht (anderer Name? docker ps -a ohne Filter).
02Ist Port 9443 veröffentlicht — und an welche Adresse?
```
sudo docker port portainer
```
Listet die Portfreigaben: Container-Port und die Host-Adresse, an die er gebunden ist.
- 9443/tcp -> 0.0.0.0:9443 → auf allen Adressen erreichbar.
- 9443/tcp -> 192.168.10.20:9443 → nur unter genau dieser IP erreichbar — passt die URL?
- Keine Zeile für 9443 → der Port ist nicht veröffentlicht (compose.yaml prüfen).
03Antwortet Portainer auf dem Server selbst?
```
curl -k https://<ip-aus-docker-port>:9443/api/system/status
```
Fragt die Status-API direkt auf dem Server ab; -k akzeptiert das selbstsignierte Zertifikat.
- JSON mit „Version“ → Portainer läuft; das Problem liegt zwischen Browser und Server (Netz, Firewall, VPN, falsche URL).
- Verbindung abgelehnt → auf dieser Adresse lauscht nichts.

Mögliche Ursachen

Hypothesen, keine Diagnose — welche zutrifft, zeigen erst die Prüfungen oben.

Der Container läuft nicht oder startet in einer Schleife neu.
Port 9443 ist nicht veröffentlicht oder an eine andere IP gebunden als die aufgerufene.
Aufruf mit http:// statt https:// oder mit dem alten Port 9000.
Bei einer frischen Instanz: Das Admin-Konto wurde nicht innerhalb von fünf Minuten angelegt — Container neu starten und neuen Setup-Token holen.
Eine Firewall oder ein fehlendes VPN liegt zwischen Browser und Server.

Häufige Fragen

Sind die Befehle gefahrlos?

Die Diagnosebefehle lesen nur: Sie zeigen Status, Logs, Ports, Rechte und Netzwerke an, ändern aber nichts. Ändernde Schritte wie Rechte anpassen oder Container neu erstellen stehen im Guide zur Fehlersuche — dort mit Erklärung, was sie bewirken.

Woher weiß der Assistent, was bei mir kaputt ist?

Gar nicht — und das ist Absicht. Er ordnet nur, welche Prüfung als Nächstes sinnvoll ist, und erklärt, wie du die Ausgabe liest. Die Platzhalter in spitzen Klammern, etwa <container>, ersetzt du durch deine eigenen Namen.

Werden meine Eingaben gespeichert?

Es gibt keine Eingaben außer der Auswahl des Symptoms. In der Adresszeile steht höchstens dessen Kennung, damit sich ein Fall verlinken lässt.

Passende Tools

Portainer-Installationsassistent →

Portainer auf Debian oder Ubuntu einrichten: Schritte, compose.yaml, Agent-Befehl und Sicherheitscheckliste — passend für LAN, VPN oder Reverse Proxy.

Docker Compose Generator →

compose.yaml für einen Dienst erstellen: Ports, Volumes, Netzwerk, Healthcheck, Limits und Härtung — mit .env für Geheimnisse und Download.