| Was du siehst | Ursache und Abhilfe |
|---|---|
port is already allocated | Ein anderes Programm belegt 5173, 8000, 9999 oder 5432. Halte es an oder ändere den Port auf dem Rechner in docker-compose.yml. |
| Die Weboberfläche lädt, meldet aber „API unreachable” | Der Api-Container ist nicht gesund: docker compose logs api. |
| Die Anmeldung scheitert von einer Adresse im Netz | WHO2BE_PUBLIC_URL ist nicht auf diese Adresse gesetzt — siehe Zugriff im lokalen Netz. |
| Das Hochladen einer Datei liefert 503 | Der Dateispeicher ist optional und aus, solange WHO2BE_BLOBSTORE_* nicht gesetzt ist (siehe .env.example). Alles andere funktioniert ohne ihn. |
| Der MCP-Client meldet 401 | Ohne Token zu erwarten — ergänze Authorization: Bearer w2b_…. Kommt HTML statt einer 401 zurück, spricht der Client mit der Weboberfläche statt mit dem MCP-Endpunkt. |
Hilft das nicht weiter, melde den Fehler im öffentlichen Verzeichnis auf GitHub (externe Seite).