Fehlerbehebung

Die meisten Probleme haben eine von wenigen Ursachen. Diese Seite ordnet sie nach dem, was Sie sehen.

Bei der Installation#

Meldung	Ursache und Abhilfe
`Bitte mit sudo aufrufen.`	Das Skript braucht Root-Rechte: `… \	sudo bash`.
`Docker läuft nicht`	`sudo systemctl start docker`, dann erneut.
`Docker Compose (v2) fehlt`	`sudo apt-get install -y docker-compose-plugin`
`Das Image … konnte nicht bezogen werden`	Kommt der Server ausgehend auf 443 zu `ghcr.io`? Löst der Name auf? Gibt es die Version? Eine Anmeldung braucht es nicht.
`Port … ist belegt`	Anderen Port wählen: `… \	sudo NETBRAIN_PORT=4330 bash`, der Proxy leitet dann dorthin.
`hat nach 180 Sekunden nicht »bereit« gemeldet`	Der Installer zeigt die letzten Protokollzeilen. Meist ist `/data` nicht beschreibbar oder eine Einstellung ungültig.

Im Browser#

Sie sehen	Ursache und Abhilfe
Fehler 421	Der aufgerufene Name steht nicht in `NETBRAIN_ALLOWED_HOSTS`, oder der Proxy schreibt den `Host`-Header um. Siehe Installation.
Anmeldung erscheint nach richtigem Passwort wieder	NETbrain wird über HTTP statt HTTPS aufgerufen, oder das Zertifikat ist abgelaufen. Siehe Reverse-Proxy.
„Zu viele Anmeldeversuche“, obwohl niemand sich vertippt hat	`NETBRAIN_TRUSTED_PROXY_HOPS` fehlt oder steht auf `0`: Alle Nutzer erscheinen als eine Adresse.
Einrichtungs-Token wird abgewiesen	Es ist ein altes. `sudo ./install.sh token` zeigt das aktuelle.
Kein Token in der Ausgabe	Die Installation ist schon eingerichtet.
Eine Datei lässt sich nicht einreichen, es erscheint eine fremde Fehlerseite	Das Body-Limit des Proxys ist kleiner als 12 MB.
Lizenzseite statt Anwendung	Testphase oder Lizenz abgelaufen, oder die Aktivierung wurde länger als sieben Tage nicht bestätigt. Siehe Lizenz.
„Aktivierung fehlgeschlagen“	Der Server erreicht den Lizenzdienst nicht (ausgehend 443 zu `lizenz-netbrain.netfactory.de`), oder die Lizenz ist schon an eine andere Installation gebunden.
Privater Vault „In diesem Browser nicht verfügbar“	Der Vault braucht Chrome oder Edge.
KI-Chat antwortet mit Fehler	Administration → KI → Modelle jetzt prüfen zeigt, welcher Anbieter nicht antwortet.

Zustand prüfen#

cd /opt/netbrain
sudo ./install.sh status

Am Ende steht die Antwort der Selbstprüfung:

bereit — alles in Ordnung.
migriert — der Bestand wird nach einem Update angepasst. Abwarten.
nicht bereit — die Einzelprüfungen daneben nennen die Ursache, meist ein nicht beschreibbares /data.

Bevor Sie uns schreiben#

Schicken Sie bitte diese beiden Ausgaben mit; sie beantworten die meisten Rückfragen vorweg:

sudo ./install.sh status
sudo ./install.sh logs

Die letzten Zeilen des Protokolls genügen, Strg + C beendet die Ausgabe. Unsere Adresse: info@netfactory.de. Aus der Anwendung heraus geht es auch über Feedback geben im Hinweisbalken.

Stand: NETbrain 0.5.9. Fehlt etwas oder stimmt etwas nicht? Schreiben Sie uns.