Fehler-Finder: Selfhosting-Fehlermeldungen nachschlagen
Container startet nicht, Zertifikat fehlt, Mail hängt? Such deine Fehlermeldung – jede Antwort stammt aus einem Setup, das wir selbst zum Laufen gebracht haben.
Jede Karte hier stammt aus einem Tutorial dieser Seite – aus einem Fehler, der uns beim Aufsetzen
auf dem Test-Server tatsächlich begegnet ist. Tipp die Fehlermeldung ein (address already in use, NXDOMAIN, Unauthorized) oder beschreib das Symptom in eigenen Worten.
400 Fundstellen aus echten Setups
Die Anmeldung springt sofort zurück und Outline zeigt „Authentication failed".
Schau in die Protokolle von Authentik:
Nachlesen: Outline: das moderne Team-Wiki mit Authentik-Login →docker compose logs server | grep -i grant. Steht dort Invalid grant_type for provider, ist beim Provider das Feld Grant types leer. In Authentik 2026.x muss Authorization Code dort ausdrücklich eingetragen sein; die Anmeldung bricht sonst schon vor der Anmeldemaske mit invalid_request ab. Outline protokolliert dazu nur OAuth error during authentication: The request is otherwise malformed – die eigentliche Ursache steht immer auf der Authentik-Seite.Nach der Anmeldung kommt redirect_uri als Fehler zurück.
Die bei Authentik hinterlegte Adresse muss exakt
Nachlesen: Outline: das moderne Team-Wiki mit Authentik-Login →https://wiki.DEINE_DOMAIN/auth/oidc.callback lauten, mit demselben Namen, den auch URL= in der .env von Outline nennt. Ein abweichender Hostname, ein zusätzlicher Schrägstrich oder http statt https reichen für die Ablehnung. Bei Matching Mode Strict gibt es keinen Spielraum – das ist Absicht.Outline zeigt keine Anmeldeseite mehr, sondern springt direkt zu Authentik.
Das ist kein Fehler: Bei genau einem eingerichteten Anmeldedienst überspringt Outline die eigene Auswahlseite. Sobald du einen zweiten Weg einrichtest, erscheint sie wieder. Wenn du die Seite sehen willst, ruf sie mit einem Hinweisparameter auf, etwa nach einem fehlgeschlagenen Versuch.
Nachlesen: Outline: das moderne Team-Wiki mit Authentik-Login →Uploads schlagen fehl, wenn du statt des Volumes einen Ordner vom Host einbindest.
Outline läuft im Container als
Nachlesen: Outline: das moderne Team-Wiki mit Authentik-Login →nodejs mit UID 1001 und kann in einen root-Ordner nicht schreiben – auf gehärteten Servern mit umask 027 erst recht nicht. Entweder du bleibst beim benannten Volume, oder du setzt chown -R 1001:1001 auf das Verzeichnis. Prüfen kannst du es mit docker exec outline ls -la /var/lib/outline/data.Outline startet, aber niemand kann sich anmelden, und in den Protokollen fehlt die Zeile OIDC plugin registered.
Dann ist mindestens eine der sechs
Nachlesen: Outline: das moderne Team-Wiki mit Authentik-Login →OIDC_-Variablen leer. Outline meldet das nicht als Fehler – es startet einfach ohne Anmeldeweg. Prüf mit docker exec outline env | grep OIDC, ob alle Werte ankommen; ein häufiger Grund ist ein $ im Client Secret, das Compose bei environment: auflöst. Mit env_file: wie hier passiert das nicht.Traefik antwortet mit 502 Bad Gateway, obwohl alle vier Container laufen.
Der nginx im Web-Container lauscht auf Port 8000, nicht auf 80, weil er unprivilegiert läuft. Setz
Nachlesen: Jitsi Meet: eigene Videokonferenzen ohne Zoom →traefik.http.services.jitsi.loadbalancer.server.port=8000. Nachsehen kannst du mit docker exec jitsi-web ss -lnt, dort steht der tatsächlich belegte Port. Derselbe Fehler entsteht, wenn traefik.docker.network=proxy fehlt und Traefik die Container-Adresse aus dem internen meet.jitsi-Netz erwischt, das es selbst nicht erreicht.Der Web-Container startet, meldet aber cp: cannot stat '/config/.': Permission denied und liefert nichts aus.
Die gemounteten Ordner unter
Nachlesen: Jitsi Meet: eigene Videokonferenzen ohne Zoom →/opt/jitsi/config gehören root, die Container laufen als UID 1000. Ein chown -R 1000:1000 /opt/jitsi/config und ein Neustart lösen das. Auf gehärteten Servern mit umask 027 trifft es dich garantiert, weil neu angelegte Ordner dann 0750 bekommen.Zu zweit läuft alles, ab dem dritten Teilnehmer hört und sieht niemand mehr etwas.
Das ist das typische Bild eines geschlossenen UDP-Ports. Es fällt erst jetzt auf, weil Jitsi Zweiergespräche direkt zwischen den Browsern führt und die Videobrücke erst ab drei Teilnehmern benutzt. Prüf
Nachlesen: Jitsi Meet: eigene Videokonferenzen ohne Zoom →ss -lunp | grep 10000 auf dem Server und die eingehende ACCEPT-Regel für UDP 10000 in beiden Firewalls. In den Protokollen der Brücke siehst du es ebenfalls: docker compose logs jvb | grep -i 'ICE state' zeigt dann Übergänge nach Terminated, ohne dass je eine Verbindung zustande kam.Alle sind im Raum, aber niemand hört oder sieht jemanden.
Das ist fast immer der Medienpfad, nicht die Konferenz. Prüf zuerst
Nachlesen: Jitsi Meet: eigene Videokonferenzen ohne Zoom →docker compose logs jvb | grep "static mapping". Steht dort keine Zeile mit deiner öffentlichen Adresse, fehlt JVB_ADVERTISE_IPS in der .env, und die Videobrücke meldet den Browsern ihre Container-Adresse. Stimmt die Adresse, ist der nächste Verdächtige UDP 10000 in der Firewall, und zwar in beiden (auf dem Server und beim Anbieter). Im netcup SCP ist das eine eigene Policy mit einer eingehenden ACCEPT-Regel auf UDP 10000; ein Web-Template mit 80/443 deckt das nicht mit ab.Nach docker compose down ist das Moderatorkonto verschwunden.
Prosody legt Konten unter
Nachlesen: Jitsi Meet: eigene Videokonferenzen ohne Zoom →/var/lib/prosody ab, und dieses Verzeichnis ist in der offiziellen Vorlage nicht gemountet: Mit dem Container verschwinden auch die Konten. Der Mount ./config/prosody/data:/var/lib/prosody:Z behebt das; die Konten liegen danach auf dem Host unter config/prosody/data/data/meet%2ejitsi/accounts/. Ein bereits verlorenes Konto legst du einfach neu an.Der Dialog „Waiting for a moderator" bleibt auch nach dem Anmelden stehen.
Dann existiert das Konto nicht in der Domäne, in der Jitsi es sucht. Registriert wird gegen
Nachlesen: Jitsi Meet: eigene Videokonferenzen ohne Zoom →meet.jitsi, die interne Domäne aus der .env, nicht deine echte. Prüf mit docker exec jitsi-prosody prosodyctl --config /run/prosody/config/prosody.cfg.lua register NAME meet.jitsi PASSWORT: Meldet der Befehl „User already exists", stimmt die Domäne und das Passwort ist falsch.Unter /_matrix/client/versions kommt die Element-Startseite statt JSON.
Beide Router hören auf denselben Host, und Traefik hat den falschen zuerst geprüft. Setz
Nachlesen: Matrix Teil 2: Element Web, Föderation und Admin-Alltag →traefik.http.routers.synapse.priority=100 und …element.priority=10. Ohne ausdrückliche Zahlen sortiert Traefik nach Regellänge, und das Ergebnis ändert sich, sobald eine weitere Regel dazukommt. Nach dem Ändern reicht docker compose up -d; Traefik liest die Labels sofort neu.Der Element-Container startet nicht und meldet cp: can't open '/app/config.json': Permission denied.
Die
Nachlesen: Matrix Teil 2: Element Web, Föderation und Admin-Alltag →element-config.json auf dem Host ist für den Container nicht lesbar. Das passiert zuverlässig auf Servern mit umask 027, weil neue Dateien dann mit 0640 und ohne Leserecht für andere entstehen. chmod 0644 /opt/matrix/element-config.json und neu starten. Das gilt für jede Konfigurationsdatei, die du per Bind-Mount in einen Container reichst.Element hängt bei „Confirm your digital identity", und „Use recovery key" ist ausgegraut.
Du meldest dich auf einem weiteren Gerät an und hast beim ersten keinen Wiederherstellungsschlüssel angelegt (Schritt 5). Ist ein altes Gerät noch angemeldet, nimm „Use another device" und bestätige dort. Sonst bleibt nur „Can’t confirm?" mit anschließendem Kontopasswort: Element setzt die Identität dann zurück, Konto, Kontakte und Räume bleiben, aber Nachrichten aus der Zeit davor bleiben unlesbar. Leg danach sofort den Wiederherstellungsschlüssel an.
Nachlesen: Matrix Teil 2: Element Web, Föderation und Admin-Alltag →Die Anmeldung schlägt plötzlich mit M_LIMIT_EXCEEDED fehl.
In der Antwort steht
Nachlesen: Matrix Teil 2: Element Web, Föderation und Admin-Alltag →retry_after_ms, die Wartezeit in Millisekunden. Synapse bremst Anmeldeversuche pro Konto und pro IP ab; das trifft dich, wenn du mehrere Sitzungen hintereinander aufbaust oder mit Skripten testest. Für den Dauerbetrieb lässt sich das über den rc_login-Block in der homeserver.yaml lockern, nur solltest du das nicht tun, denn genau diese Bremse hält Rateversuche auf.In der Geräteliste und in den Protokollen steht 172.x.x.x statt der echten Besucher-IP.
Das betrifft nur Anfragen über IPv6, bei einer Domain mit AAAA-Eintrag also die Mehrheit. Das
Nachlesen: Matrix Teil 2: Element Web, Föderation und Admin-Alltag →proxy-Netz wird im Traefik-Tutorial mit docker network create proxy angelegt, und das ist ein reines IPv4-Netz. Docker kann eine eingehende IPv6-Verbindung dann nicht direkt auf den Container umschreiben und schickt sie über einen Hilfsprozess, der die Absenderadresse durch die des Bridge-Gateways ersetzt; über IPv4 stimmt sie die ganze Zeit. Abhilfe ist ein Netz mit IPv6: in allen Stacks docker compose down, dann docker network rm proxy && docker network create --ipv6 --subnet fd00:cafe::/64 proxy und alles wieder hochfahren; die Schritte stehen im Reverse Proxy mit Traefik. Danach steht bei IPv4 und IPv6 die echte Adresse in X-Forwarded-For.Synapse startet nicht und meldet IncorrectDatabaseSetup: Database has incorrect collation.
Die Datenbank wurde mit einer sprachabhängigen Sortierung angelegt, etwa
Nachlesen: Matrix: der eigene Chat-Server mit Synapse (Teil 1) →de_DE.utf8; Synapse erwartet C. Das lässt sich nachträglich nicht umstellen, denn die Sortierreihenfolge steht beim Anlegen der Datenbank fest. Lösch das Volume und starte mit POSTGRES_INITDB_ARGS: "--encoding=UTF8 --lc-collate=C --lc-ctype=C" neu. Die Fehlermeldung bietet allow_unsafe_locale als Ausweg an; nimm den nicht, denn falsch sortierte Indizes fallen dir später bei der Suche auf die Füße.Der Föderationstester meldet FederationOK: false, obwohl die Seite im Browser lädt.
Dann stimmt meist die Delegation nicht. Prüf
Nachlesen: Matrix: der eigene Chat-Server mit Synapse (Teil 1) →curl -s https://DEINE_DOMAIN/.well-known/matrix/server. Die Antwort muss den Host mit Port enthalten, also etwa {"m.server":"DEINE_DOMAIN:443"}. Kommt hier ein 404, fehlt serve_server_wellknown: true in der Konfiguration oder ein anderer Dienst fängt den Pfad ab. Ebenfalls häufig: Der Servername in der Delegation zeigt auf einen Host, dessen Zertifikat auf einen anderen Namen ausgestellt ist.In den Logs steht bei jedem Zugriff die IP von Traefik statt der des Besuchers.
Es fehlt
Nachlesen: Matrix: der eigene Chat-Server mit Synapse (Teil 1) →x_forwarded: true im listeners-Block. Synapse wertet die Weiterleitungs-Header nur aus, wenn du es ihm ausdrücklich erlaubst. Ohne echte Absender-IP kannst du weder Missbrauch nachvollziehen noch fail2ban sinnvoll einsetzen.Die Anmeldung schlägt mit M_FORBIDDEN fehl, obwohl das Passwort stimmt.
Prüf, ob du dich wirklich am richtigen Server anmeldest: Die Benutzer-ID lautet
Nachlesen: Matrix: der eigene Chat-Server mit Synapse (Teil 1) →@name:server_name, nicht @name:host. Wenn server_name und der Host auseinanderfallen und die Client-Delegation fehlt, landet dein Programm am falschen Ort. curl -s https://DEINE_DOMAIN/.well-known/matrix/client muss die Basis-URL des Homeservers liefern.Der Server läuft, aber der Speicher wird knapp.
Synapse belegt im Leerlauf wenig (gut 100 MB), wächst aber deutlich, sobald du großen, stark föderierten Räumen beitrittst, weil er deren gesamte Historie mitverwaltet. Wenn es eng wird, hilft als Erstes, solche Räume zu verlassen und anschließend mit der Aufräumfunktion der Admin-API alte Ereignisse zu entfernen. Mehr Arbeitsspeicher ist die andere Antwort; ein Homeserver, der in echten Räumen mitspielt, ist auf 1 GB nicht glücklich.
Nachlesen: Matrix: der eigene Chat-Server mit Synapse (Teil 1) →vmstat zeigt dauerhaft 100 Prozent id, obwohl die Seite spürbar langsam ist.
Dann
ist der Engpass nicht auf diesem Server. Prüfe die Antwortzeit direkt am Dienst statt über
die Domain – wenn der Container schnell antwortet und der Browser trotzdem wartet, liegt es
am Weg dorthin: DNS, TLS-Handshake oder ein überlastetes Netz, nicht an CPU oder RAM.
Nachlesen: Wann reicht der kleine Server nicht mehr? →Im Kernel-Log steht gar nichts, obwohl ein Container verschwunden ist.
journalctl -k
zeigt nur echte OOM-Abschüsse. Beendet sich ein Dienst selbst, steht der Grund in seinem
eigenen Log: docker compose logs --tail 50 DEIN_DIENST. Ein exit 137 ohne passende
Kernel-Zeile ist meistens ein docker stop mit abgelaufener Frist, kein Speicherproblem.Der Load-Average ist hoch, aber r und b stehen beide auf 0.
Du liest die erste
Nachlesen: Wann reicht der kleine Server nicht mehr? →vmstat-Zeile. Die ist ein Mittelwert seit dem Systemstart und auf einem Server mit 80 Tagen
Laufzeit praktisch bedeutungslos. Nimm vmstat 1 5 und werte ab der zweiten Zeile aus.free -h meldet fast keinen freien Speicher, der Server läuft aber tadellos.
Das ist der
Normalzustand. Der Kernel füllt ungenutzten Speicher mit Dateicache und gibt ihn sofort
wieder her, wenn jemand ihn braucht. Entscheidend ist die Spalte
Nachlesen: Wann reicht der kleine Server nicht mehr? →available; free darf
getrost nahe null stehen.Viel Reclaimable, aber docker image prune -a gibt kaum etwas frei.
Dann hängen die
Images noch an gestoppten Containern. Erst
Nachlesen: Wann reicht der kleine Server nicht mehr? →docker container prune,
dann die Images – oder in einem Rutsch docker system prune -a, nachdem du geprüft hast,
dass alle gewünschten Stacks wirklich laufen.Der Container startet immer neu und meldet error loading flags: flag needs an argument: --config.
Beim Kopieren der
Nachlesen: listmonk: eigener Newsletter-Server, DSGVO-freundlich →command-Zeile sind die beiden einfachen Anführungszeichen hinter --config verlorengegangen – das passiert leicht, wenn man den Befehl durch mehrere Shell-Ebenen schickt. Prüf mit docker inspect listmonk --format '{{json .Config.Cmd}}', was tatsächlich ankommt: Dort muss hinter jedem --config ein leeres Argument stehen. Schreib die Compose-Datei im Zweifel mit einem Editor direkt auf dem Server statt sie über verschachtelte Anführungszeichen zu erzeugen.listmonk startet nicht mehr und meldet error reading SMTP config: decoding failed.
In den gespeicherten Einstellungen steht ein ungültiger Wert – etwa eine Zeitangabe ohne Einheit. Das Tückische: Die Weboberfläche ist dann nicht erreichbar, du kannst es also nicht dort korrigieren. Die Einstellungen liegen in der Tabelle
Nachlesen: listmonk: eigener Newsletter-Server, DSGVO-freundlich →settings; mit docker compose exec db psql -U listmonk -d listmonk kommst du heran und kannst den Schlüssel smtp per UPDATE wieder auf einen gültigen Block setzen. Danach docker compose restart app.Der Datenbank-Container startet nicht und redet von pg_ctlcluster.
Das ist die PostgreSQL-18-Umstellung: Der Mount darf nicht mehr auf
Nachlesen: listmonk: eigener Newsletter-Server, DSGVO-freundlich →/var/lib/postgresql/data zeigen, sondern muss auf /var/lib/postgresql. Bei einer bestehenden Datenbank reicht das Verschieben nicht – dort brauchst du pg_dump mit der alten Hauptversion und einen Import in die neue.Die Kampagne bleibt auf running stehen und es wird nichts versendet.
Dann erreicht listmonk den SMTP-Server nicht.
Nachlesen: listmonk: eigener Newsletter-Server, DSGVO-freundlich →docker compose logs app | grep -i smtp zeigt den Grund; häufig ist es ein falscher Port (587 statt 465 oder umgekehrt), eine falsche TLS-Einstellung oder ein Provider, der Port 25 nach außen sperrt. Zum Eingrenzen hilft der lokale Auffang-Server aus Schritt 3: Funktioniert der Versand dorthin, liegt es nicht an listmonk.Die Mails kommen an, landen aber im Spam.
Das ist kein listmonk-Problem. Prüf, ob SPF, DKIM und DMARC für die Absenderdomain stimmen und ob die Absenderadresse zur Domain passt, über die du versendest – wie das geht, steht in Mailserver-Zustellbarkeit. Vermeide außerdem reines Bild-HTML und schick beim ersten Mal an eine kleine Liste, statt zehntausend Adressen auf einmal anzuschreiben.
Nachlesen: listmonk: eigener Newsletter-Server, DSGVO-freundlich →Der Datenbank-Container startet nicht und meldet etwas über pg_ctlcluster und Verzeichnisnamen.
Das ist die PostgreSQL-18-Umstellung: Ab dieser Hauptversion darf der Mount nicht mehr auf
Nachlesen: HedgeDoc: gemeinsame Markdown-Notizen in Echtzeit →/var/lib/postgresql/data zeigen, sondern muss eine Ebene höher auf /var/lib/postgresql. Der Container bricht auch dann ab, wenn das Volume nagelneu und leer ist – die Prüfung hängt am Mount, nicht am Inhalt. Bei einer bestehenden Datenbank reicht das Verschieben des Mounts allerdings nicht; dann brauchst du erst einen pg_dump mit der alten Hauptversion und einen Import in die neue.Nach dem Umstellen des Mounts kommt mkdir: can't create directory '/var/lib/postgresql/18/': Permission denied.
Du benutzt einen Bind-Mount, und das Verzeichnis auf dem Host gehört root – der Postgres-Benutzer im Container darf darin nichts anlegen. Am alten Pfad hat das Image die Rechte noch selbst korrigiert, am neuen nicht mehr. Entweder du gibst das Verzeichnis dem Container-Benutzer, oder du nimmst wie hier ein benanntes Volume, bei dem Docker die Rechte aus dem Image übernimmt.
Nachlesen: HedgeDoc: gemeinsame Markdown-Notizen in Echtzeit →Verschickte Links zeigen auf localhost oder tragen einen Port im Namen.
HedgeDoc baut Links nicht aus dem
Nachlesen: HedgeDoc: gemeinsame Markdown-Notizen in Echtzeit →Host-Header, sondern aus der Konfiguration. Setz CMD_DOMAIN auf deine Domain (nur den Namen, kein https://, kein Pfad), CMD_PROTOCOL_USESSL auf true und CMD_URL_ADDPORT auf false. Nach einer Änderung muss der Container neu gestartet werden, damit sie greift.Ein Gast hat deine Notiz bearbeitet, obwohl CMD_ALLOW_ANONYMOUS_EDITS auf false steht.
Diese Option wirkt ausschließlich dann, wenn
Nachlesen: HedgeDoc: gemeinsame Markdown-Notizen in Echtzeit →CMD_ALLOW_ANONYMOUS auf false steht – bei true ist sie wirkungslos. Entscheidend ist die Berechtigung der einzelnen Notiz: Steht sie auf Freely, darf jeder mit dem Link schreiben. Setz CMD_ALLOW_ANONYMOUS auf false, starte den Container neu und stell die Notiz auf Limited oder Locked.In der Notizliste tauchen Notizen wie wp-json oder xmlrpc.php auf, die niemand angelegt hat.
Das waren Bots, die nach WordPress suchen. Bei
Nachlesen: HedgeDoc: gemeinsame Markdown-Notizen in Echtzeit →CMD_ALLOW_ANONYMOUS: "true" zusammen mit CMD_ALLOW_FREEURL: "true" legt jeder Aufruf einer freien Adresse eine neue Notiz an. Stell CMD_ALLOW_ANONYMOUS auf false und starte den Stack neu. Die bereits angelegten Notizen haben keinen Besitzer, der sie in der Oberfläche löschen könnte; du entfernst sie in der Datenbank: docker compose exec database psql -U hedgedoc -d hedgedoc -c 'DELETE FROM "Notes" WHERE "ownerId" IS NULL;' – ihre Revisionen verschwinden dabei mit.Ein Außenstehender bekommt beim veröffentlichten Link nur eine Weiterleitung auf die Startseite.
Dann steht die Notiz auf
Nachlesen: HedgeDoc: gemeinsame Markdown-Notizen in Echtzeit →Limited oder Protected – beide Stufen sperren Gäste komplett aus, auch bei veröffentlichten Fassungen. Für „nur lesen, aber für alle" ist Locked die richtige Wahl. CMD_ALLOW_ANONYMOUS hat damit nichts zu tun: Die Option regelt nur, ob Gäste Notizen anlegen dürfen, nicht, ob sie welche lesen.Pingvin Share X: Die Seite antwortet mit 403 Forbidden.
Die Sperre aus Schritt 1 lässt deine Adresse nicht durch. Meist fehlt die IPv6 oder sie hat sich geändert – frag beide Adressen erneut ab (siehe dort), korrigiere
Nachlesen: Pingvin Share X: große Dateien teilen ohne WeTransfer →sourcerange und starte mit docker compose up -d neu.Die verschickten Links zeigen auf http://localhost:3000.
Die App URL unter Configuration → General steht noch auf dem Standardwert. Pingvin kennt seine öffentliche Adresse nicht von allein – der Reverse Proxy sagt sie ihm nicht. Trag
Nachlesen: Pingvin Share X: große Dateien teilen ohne WeTransfer →https://DEINE_DOMAIN ein und speichere; bereits verschickte Links musst du neu erzeugen.In den Zugriffsprotokollen steht bei jedem Besucher dieselbe IP.
Das ist die Adresse aus dem Docker-Proxy-Netz, und es fehlt
Nachlesen: Pingvin Share X: große Dateien teilen ohne WeTransfer →TRUST_PROXY: "true" in der Compose-Datei. Erst damit wertet Pingvin die X-Forwarded-For-Header aus. Setz den Wert aber wirklich nur, wenn ein Proxy davorsteht – ohne einen kann sich sonst jeder Client eine beliebige Quell-IP ausdenken.Ein großer Upload bricht mittendrin ab.
Prüf zuerst die Max size unter Configuration → Share; ab Werk sind das 1 GB, und die Oberfläche sagt es dir schon vor dem Hochladen („Maximum total upload size: 1 GB."). Bleibt es dabei, ist die Chunk size der nächste Hebel: Kleinere Stücke als die voreingestellten 10 MB sind bei wackligen Verbindungen zuverlässiger, größere bei stabilen schneller.
Nachlesen: Pingvin Share X: große Dateien teilen ohne WeTransfer →Fremde legen Konten auf deiner Instanz an.
Dann steht Allow registration noch auf an – der Auslieferungszustand. Schalte es unter Configuration → Security & Access ab und lösch die fremden Konten unter Administration → User management. Zur Kontrolle:
Nachlesen: Pingvin Share X: große Dateien teilen ohne WeTransfer →curl -s -o /dev/null -w "%{http_code}\n" https://DEINE_DOMAIN/auth/signUp muss danach 307 liefern und nicht 200.Nach dem Anmelden wirst du sofort wieder ausgeloggt.
Meist ist Secure cookies eingeschaltet, während der Aufruf über
Nachlesen: Pingvin Share X: große Dateien teilen ohne WeTransfer →http:// läuft – dann verwirft der Browser das Cookie. Ruf die Seite über HTTPS auf. Wenn du Pingvin bewusst ohne TLS betreibst, muss der Schalter aus bleiben; die Einstellung sagt das selbst: „If enabled, the site will not function when accessed over HTTP."eosctl compute vm delete meldet nichts, die VM läuft weiter.
eos löscht nur ausgeschaltete
VMs und sagt das nicht. Erst
Nachlesen: netcup eos automatisieren: eosctl und OpenTofu →eosctl compute vm power-off, warten bis power_state auf
stopped steht, dann löschen (Schritt 6).exec klappt direkt nach dem Anlegen nicht.
started heißt nur, dass die VM läuft. Der
Agent, über den exec arbeitet, braucht eine halbe Minute länger – warte, bis agent_ready auf
true steht (Schritt 4).Von mehreren Befehlen kommt nur die erste Ausgabe zurück.
Die inneren Anführungszeichen in
Nachlesen: netcup eos automatisieren: eosctl und OpenTofu →bash -c sind einfache. Nimm maskierte doppelte, wie in Schritt 5.OpenTofu bricht beim Anlegen mit einem Berechtigungsfehler ab.
Lesen darf jeder Zugang,
schreiben nur mit Rolle. Für dieses Setup braucht er
Nachlesen: netcup eos automatisieren: eosctl und OpenTofu →compute:network-manager und
compute:vm-manager. Prüfe außerdem in der Liste der Client Credentials, ob er abgelaufen ist,
und lege notfalls einen neuen an.tofu init findet den Provider nicht.
Die
Nachlesen: netcup eos automatisieren: eosctl und OpenTofu →source muss den Hostnamen enthalten:
dl.eoscloud.io/eos/eoscloud. Ohne ihn sucht OpenTofu in seiner eigenen Registry, wo der
Provider nicht liegt.Der Login mit dem richtigen Passwort schlägt fehl, obwohl der Hash stimmt.
Dann steht der Hash vermutlich in einer
Nachlesen: code-server: VS Code im Browser auf dem eigenen Server →.env oder unter environment:. Docker Compose interpoliert $-Zeichen auch in Werten aus Env-Dateien, und aus $argon2id$v=19$m=65540,... wird dabei =19=65540,t=3,p=4/Ntxaqbs... – Compose warnt dabei nur mit The "argon2id" variable is not set. Entweder du verdoppelst jedes $ zu $$, oder du machst es wie hier und legst den Hash in config.yaml ab, wo Compose gar nicht hinschaut.Traefik antwortet mit 401, obwohl du das richtige BasicAuth-Passwort eingibst.
Gleiche Ursache an anderer Stelle: Im
Nachlesen: code-server: VS Code im Browser auf dem eigenen Server →basicauth.users-Label muss jedes $ des bcrypt-Hashes verdoppelt werden. Prüf mit docker compose config, was tatsächlich ankommt – steht dort ein verstümmelter Hash, fehlt die Verdopplung.Im Terminal kommt bash: python3: command not found.
Das offizielle Image enthält nur den Editor, keine Sprachlaufzeiten –
Nachlesen: code-server: VS Code im Browser auf dem eigenen Server →git, curl und sudo sind da, mehr nicht. Bau das abgeleitete Image aus Schritt 2 und starte mit docker compose up -d --build neu. Nachinstallieren im laufenden Container hilft nur bis zum nächsten Neustart.code-server kann eine Datei nicht speichern und meldet Permission denied.
Die Ordner unter
Nachlesen: code-server: VS Code im Browser auf dem eigenen Server →projekte gehören root statt der UID 1000. Das passiert, sobald du auf dem Host als root ein Verzeichnis anlegst. chown -R 1000:1000 /opt/code-server/projekte behebt es; angewöhnen solltest du dir, neue Projekte im Editor selbst anzulegen statt auf dem Host.sudo im Terminal bricht mit The "no new privileges" flag is set ab.
Das ist kein Defekt, sondern die Wirkung von
Nachlesen: code-server: VS Code im Browser auf dem eigenen Server →security_opt: no-new-privileges:true. Nimm die Zeile nicht heraus – sie ist der einzige Grund, warum das mitgelieferte coder ALL=(ALL) NOPASSWD:ALL aus /etc/sudoers.d/nopasswd niemandem mehr nützt. Was du dauerhaft brauchst, gehört in den Dockerfile.Ausgehende Mail läuft in einen Timeout auf Port 25, 465 oder 587.
Das ist nicht deine
Konfiguration, sondern netcups Default-Policy „netcup Mail block". Nimm sie dem Server im SCP
unter Firewall → Policys ab – kein Ticket nötig, siehe
netcup-Firewall einrichten.
Nachlesen: 100 Tage netcup: was dir vorher niemand sagt →DNS oder Zeitsynchronisation funktionieren nicht, obwohl ausgehend alles erlaubt ist.
Die
netcup-Firewall arbeitet bei UDP zustandslos und lässt die Antwortpakete nicht automatisch
durch. Lege Eingangsregeln für Quellport 53 (DNS) und 123 (NTP) an.
Nachlesen: 100 Tage netcup: was dir vorher niemand sagt →Ein Dienst antwortet auf dem Server, aber nicht von außen.
Dann hält ihn die SCP-Firewall
auf, nicht die auf dem Server. Eingehend offen sind nur 22, 80 und 443; jeder weitere Port
braucht eine eigene Policy. Prüf gegen
Nachlesen: 100 Tage netcup: was dir vorher niemand sagt →curl von einem fremden Rechner, nicht von localhost.Die Platte ist voll, aber du findest keine großen Dateien.
Sieh bei Docker nach:
Nachlesen: 100 Tage netcup: was dir vorher niemand sagt →docker system df zeigt dir, wie viel in Images steckt und wie viel davon wegwerfbar ist. Bei
uns waren es 68 GB von 73 GB Belegung. docker image prune -a räumt auf.Ein Container wird vom Kernel beendet (OOM), obwohl der Server Luft hat.
Dann greift ein
Speicherlimit des Containers, nicht das des Hosts. Im Log steht in diesem Fall
Nachlesen: 100 Tage netcup: was dir vorher niemand sagt →constraint=CONSTRAINT_MEMCG. Genau einmal ist uns das passiert – erhöhe das Limit des Dienstes,
bevor du über einen größeren Server nachdenkst.Von außen kommt weiterhin 200 statt 403.
Fast immer ist die Middleware zwar definiert, aber nicht am Router angehängt. Die beiden Labels haben unterschiedliche Aufgaben:
Nachlesen: Dienste nur im VPN erreichbar machen →traefik.http.middlewares.vpn-only.ipallowlist.sourcerange=… legt sie an, traefik.http.routers.DEINROUTER.middlewares=vpn-only benutzt sie. Fehlt die zweite Zeile, startet alles fehlerfrei und der Dienst ist offen – ohne jede Fehlermeldung. Das Suffix @docker ist dabei optional, solange Middleware und Router aus demselben Provider kommen.Auch aus dem VPN kommt 403.
Dann sieht Traefik eine andere Quell-IP als die des VPN-Clients. Prüf das mit
Nachlesen: Dienste nur im VPN erreichbar machen →curl -s https://DEINE_DOMAIN/ | grep X-Real-Ip gegen einen whoami-Container: Steht dort eine Docker-interne Adresse wie 172.19.0.x oder die IP eines CDN, liegt noch ein Proxy davor. In dem Fall musst du Traefik über forwardedHeaders.trustedIPs beibringen, welchen Vorgänger er glauben darf – ohne diese Einstellung wertet er den Header nicht aus.Der Name löst im VPN weiter auf die öffentliche IP auf.
Der Client benutzt AdGuard nicht. Kontrollier zuerst
Nachlesen: Dienste nur im VPN erreichbar machen →cat /etc/resolv.conf – steht dort nicht nameserver 10.8.0.1, hat DNS = 10.8.0.1 nicht gegriffen. wg-quick braucht dafür ein Werkzeug, das die Resolver-Konfiguration ändern kann: entweder resolvconf aus dem Paket openresolv oder resolvectl aus dem Paket systemd-resolved. Auf einem minimalen Debian 13 ist keins von beiden vorinstalliert, und dann bleibt die Zeile wirkungslos. Ob AdGuard selbst richtig antwortet, prüfst du unabhängig davon mit dig +short @10.8.0.1 DEINE_DOMAIN.Das Zertifikat wird plötzlich nicht mehr erneuert.
Der ACME-Abruf braucht den öffentlichen Weg. Wenn du zwischendurch den A-Record gelöscht, Port 80 geschlossen oder die Allowlist versehentlich am
Nachlesen: Dienste nur im VPN erreichbar machen →web-Entrypoint global gesetzt hast, kommt Let’s Encrypt nicht mehr an die Challenge. docker compose logs traefik | grep -i acme zeigt den Fehlschlag – aber eben erst kurz vor Ablauf, nicht sofort.Der Dienst antwortet im VPN, aber nur manchmal.
Das ist meist die Reihenfolge der Adressfamilien: Solange der Name noch eine AAAA-Antwort liefert, probiert der Client zuerst IPv6 – und landet damit außerhalb des Tunnels bei der
Nachlesen: Dienste nur im VPN erreichbar machen →403. Leg die DNS-Umschreibung nur für IPv4 an, dann liefert AdGuard für diesen Namen gar keine AAAA mehr; dig +short AAAA @10.8.0.1 DEINE_DOMAIN muss leer bleiben.Du trägst eine öffentliche IPv6-Adresse in die Allowlist ein, und es bleibt bei 403.
Traefik vergleicht mit der Adresse, die es tatsächlich sieht – und das ist bei IPv6 die des Bridge-Gateways, solange das
Nachlesen: Dienste nur im VPN erreichbar machen →proxy-Netz ohne IPv6 angelegt wurde. Deine echte Adresse kommt in dem Vergleich gar nicht vor. Prüf das mit der Ausgabe von curl -s -6 https://DEINE_DOMAIN/ | grep X-Forwarded-For aus dem erlaubten Netz heraus: Steht dort 172.x.x.x, leg das proxy-Netz mit --ipv6 neu an (siehe Reverse Proxy mit Traefik). Für den VPN-Fall in diesem Tutorial spielt das keine Rolle, weil WireGuard hier über IPv4 läuft.SSH meldet Connection refused, obwohl IP und ACL stimmen.
Auf der VM läuft kein
SSH-Server – auch die Cloud-Images bringen keinen mit. Öffne die Web-Konsole, installiere ihn
mit
Nachlesen: netcup eos ausprobiert: die neue Cloud in der Preview →apt install openssh-server und nimm das Paket für künftige VMs in deine Cloud-Init-Datei
auf (Abschnitt „Cloud-Init: der SSH-Server fehlt“).Der Schlüssel wird abgelehnt, im Log steht account is locked.
Deine Cloud-Init-Datei
enthält
Nachlesen: netcup eos ausprobiert: die neue Cloud in der Preview →ssh_pwauth. Damit entsteht eine einzeilige sshd_config ohne UsePAM yes. Prüfe mit
wc -l /etc/ssh/sshd_config – steht dort 1, lösche die Datei in der Web-Konsole, installiere
das Paket mit apt install --reinstall -o Dpkg::Options::=--force-confmiss openssh-server neu und
starte den Dienst mit systemctl restart ssh. Danach liegt wieder Debians vollständige
Konfiguration auf der Platte.Die VM hat eine öffentliche IP, ist aber nicht erreichbar.
Es fehlt die ACL-Regel. Eingehend
ist ohne Regel alles gesperrt; lege eine Allow-Regel für den Port an, mit der internen IP der VM
als Ziel.
Nachlesen: netcup eos ausprobiert: die neue Cloud in der Preview →Failed to create ACL Rule direkt nach dem Speichern.
Das Ziel ist als
Nachlesen: netcup eos ausprobiert: die neue Cloud in der Preview →@vm-name
eingetragen. Trage stattdessen die interne IP der VM ein, die auf der Detailseite steht.Eine Default-IP lässt sich nicht an die VM hängen.
Die beiden öffentlichen Adressen, die jedes
Netz mitbringt, sind für ausgehenden Verkehr und Port-Weiterleitungen reserviert. Lege eine
eigene Public IP im selben Netz an und hänge diese an.
Nachlesen: netcup eos ausprobiert: die neue Cloud in der Preview →Headscale startet nicht und meldet headscale now requires a new noise.private_key_path field.
In der
Nachlesen: Headscale: das eigene Tailscale-Netz →config.yaml fehlt der Block noise: mit private_key_path: /var/lib/headscale/noise_private.key (Schritt 1). Den Schlüssel selbst musst du nicht anlegen, das erledigt Headscale beim Start.Headscale startet in einer Schleife neu, im Log steht loading policy: open /etc/headscale/policy.json: no such file or directory.
policy.path zeigt auf eine Datei, die es noch nicht gibt. Leg die Alles-erlauben-Datei aus Schritt 1 an oder gleich deine echten Regeln aus Schritt 7.apt-get update meldet The repository 'https://pkgs.tailscale.com/...' is not signed.
Schau in die Zeile darüber, dort steht meist
Nachlesen: Headscale: das eigene Tailscale-Netz →Failed to parse keyring ... Permission denied (os error 13). Ursache ist eine strengere UMASK (etwa 027) auf dem System: curl -o legt den Schlüssel dann mit Modus 0640 an, und apt prüft Signaturen als unprivilegierter Benutzer _apt, der die Datei nicht lesen darf. chmod 0644 /usr/share/keyrings/tailscale-archive-keyring.gpg /etc/apt/sources.list.d/tailscale.list behebt es sofort.Headscale startet nicht und meldet server_url cannot use the same domain as base_domain.
dns.base_domain und die Domain in server_url überschneiden sich. Headscale verweigert das, weil sonst der eigene Control-Server über MagicDNS aufgelöst würde und sich damit selbst unerreichbar machen könnte. Wähl für base_domain eine eigene, nicht öffentliche Zone wie kueche.internal und prüf die Datei vor jedem Neustart mit docker compose exec headscale headscale configtest.In den Logs steht listening without TLS but ServerURL does not start with http://.
Das ist keine Fehlfunktion, sondern der Normalzustand hinter einem Reverse Proxy: Headscale selbst spricht HTTP, Traefik macht das TLS. Ein echtes Problem erkennst du daran, dass
Nachlesen: Headscale: das eigene Tailscale-Netz →curl https://DEINE_DOMAIN/health nicht {"status":"pass"} liefert – dann liegt es an Traefik, nicht an Headscale.Ein Client verbindet sich nicht und bleibt bei der Anmeldung hängen.
Prüf zuerst die Clientversion mit
Nachlesen: Headscale: das eigene Tailscale-Netz →tailscale version: Headscale 0.29 weist alles unterhalb von 1.80 ab, und die Distributionspakete mancher LTS-Systeme liegen darunter. Steht die Version, ist der nächste Verdächtige der Pre-Auth-Key – Standardlaufzeit ist eine Stunde, und preauthkeys list zeigt dir in der Spalte Expiration, ob er noch gilt.Eine Subnetz-Route ist freigegeben und im Client installiert, das Ziel bleibt trotzdem unerreichbar.
Wenn das Zielnetz ein Docker-Netzwerk auf demselben Host ist, blockiert Docker den Verkehr selbst. In der Filterkette steht
Nachlesen: Headscale: das eigene Tailscale-Netz →-A DOCKER ! -i br-XXXX -o br-XXXX -j DROP, und Pakete, die über tailscale0 hereinkommen, fallen genau darauf. Für Container-Netze nimmst du deshalb keine Subnetz-Route, sondern veröffentlichst den Dienst regulär über den Reverse Proxy. Bei echten LANs prüfst du stattdessen, ob auf dem Subnetz-Router net.ipv4.ip_forward=1 gesetzt ist.Nach dem Setzen von UMASK 027 startet ein Dienst nicht mehr und meldet „Permission denied" auf seine eigene Konfigurationsdatei.
Die neue umask gilt ab der nächsten Anmeldung, und alles, was du danach mit
Nachlesen: Wie sicher ist mein Server? Selbst-Audit mit Lynis →> oder cat > anlegst, bekommt Modus 0640 statt 0644. Dienste, die unter einem eigenen Benutzer laufen – systemd-timesyncd etwa nutzt DynamicUser –, dürfen die Datei dann nicht mehr lesen. Im Journal steht Failed to open ...: Permission denied. Setz die Rechte für Konfigurationsdateien, die nicht root gehören, explizit: chmod 0644 /etc/systemd/timesyncd.conf.d/99-lynis.conf.Nach dem Anwenden der sysctl-Werte haben alle Container kein Netz mehr.
Dann ist
Nachlesen: Wie sicher ist mein Server? Selbst-Audit mit Lynis →net.ipv4.conf.all.forwarding auf 0 gelandet. Lynis schlägt das vor, Docker kann ohne IP-Forwarding aber keine Pakete zwischen Containernetz und Außenwelt weiterreichen. Nimm die Zeile aus /etc/sysctl.d/99-lynis.conf heraus und setz den Wert mit sysctl -w net.ipv4.conf.all.forwarding=1 sofort zurück – ein Neustart von Docker allein hilft nicht.systemd-timesyncd did not synchronized the time recently bleibt stehen, obwohl timedatectl NTPSynchronized=yes meldet.
Lynis prüft nicht die Uhr, sondern das Alter von
Nachlesen: Wie sicher ist mein Server? Selbst-Audit mit Lynis →/run/systemd/timesync/synchronized, und warnt ab 2048 Sekunden. Da systemd sein Abfrageintervall bei stabiler Uhr genau auf 2048 Sekunden hochzieht, läuft der Test zwangsläufig in die Warnung. Entweder du senkst PollIntervalMaxSec wie in Schritt 4 oder du nimmst den Test in custom.prf auf – ignorieren solltest du ihn nicht, denn dann übersiehst du den Tag, an dem die Zeitsynchronisation wirklich hängt.Lynis meldet Consider hardening SSH configuration zehnmal und sagt nicht, was gemeint ist.
Die Bildschirmausgabe kürzt die Details weg. Sie stehen im dritten Feld von
Nachlesen: Wie sicher ist mein Server? Selbst-Audit mit Lynis →grep "^suggestion\[\]=SSH-7408" /var/log/lynis-report.dat – dort findest du für jede Zeile den Parameter und den Zielwert.Nach der Installation von auditd ist ein Finding dazugekommen statt weg.
ACCT-9630 meldet einen laufenden Audit-Daemon mit leerem Regelwerk. Das ist beabsichtigt: auditd ohne Regeln verbraucht Ressourcen, ohne etwas zu protokollieren. Leg Regeln unter /etc/audit/rules.d/ ab und lade sie mit augenrules --load – oder deinstalliere auditd wieder, wenn du das Protokoll nicht auswertest.Der Container startet nicht und meldet Operation not permitted.
Du hast eine
Capability zu viel entzogen. Die Meldung nennt fast immer den Systemaufruf –
Nachlesen: Docker-Container absichern mit Least Privilege →chown(...) failed heißt CHOWN, setgid heißt SETGID. Gib genau diese eine zurück
(cap_add: [CHOWN]) und starte neu; arbeite dich so an das Minimum heran, statt pauschal
mehrere Capabilities auf Verdacht zu setzen.Der Container läuft laut docker compose ps, antwortet aber nicht.
Up heißt nur,
dass PID 1 lebt – nicht, dass die Anwendung arbeitet. Bei nginx sterben ohne
SETUID/SETGID die Worker, während der Master weiterläuft. Prüfe mit docker exec CONTAINER ps -o pid,user,comm, ob mehr als ein Prozess da ist, und sieh ins Log:
docker compose logs | grep -iE "alert|emerg".Read-only file system beim Start.
Die Anwendung braucht ein Schreibverzeichnis, das
du noch nicht als
Nachlesen: Docker-Container absichern mit Least Privilege →tmpfs bereitgestellt hast. Den Pfad nennt die Fehlermeldung; trag ihn
unter tmpfs: ein. Achtung: Echte Daten gehören nie ins tmpfs – das ist RAM und
beim Neustart weg. Dafür weiterhin ein Volume verwenden.Die Seite liefert 403 Forbidden, im Log steht is forbidden (13: Permission denied).
nginx läuft als UID 101 und darf die Dateien im eingehängten Verzeichnis nicht lesen – typisch
für Server mit
Nachlesen: Docker-Container absichern mit Least Privilege →UMASK 027, wo root neue Dateien ohne Leserecht für andere anlegt. Mit ls -l
prüfen und mit chmod -R a+rX site beheben.Permission denied im tmpfs, obwohl read_only passt.
Ein
Nachlesen: Docker-Container absichern mit Least Privilege →tmpfs gehört
standardmäßig root. Wenn du user: gesetzt hast, muss der Mount die UID mitbekommen:
/var/cache/nginx:uid=101,gid=101. Die richtige UID findest du mit docker run --rm DEIN_IMAGE id NUTZERNAME.Der Container wird ohne Vorwarnung beendet, docker inspect zeigt ExitCode 137.
Das
ist der OOM-Killer:
Nachlesen: Docker-Container absichern mit Least Privilege →mem_limit ist zu knapp. Prüfe den echten Bedarf im Betrieb mit
docker stats --no-stream und setz das Limit mit etwas Luft darüber. Ein Limit ganz
wegzulassen ist die schlechtere Lösung – dann reißt der Container im Zweifel den Server
mit.Es kommt gar keine Code-Abfrage, die Anmeldung läuft wie vorher durch.
Dann ist
Nachlesen: SSH mit Zwei-Faktor-Authentifizierung (TOTP) absichern →KbdInteractiveAuthentication noch no – auf Debian 13 der Standard. Prüfe mit
sudo sshd -T | grep kbdinteractive, was wirklich gilt, und beachte: Dateien in
/etc/ssh/sshd_config.d/ werden in alphabetischer Reihenfolge gelesen, die erste Festlegung
gewinnt.Nach dem Schlüssel wird zusätzlich das Passwort verlangt.
Kein Fehler, sondern die Folge von
Nachlesen: SSH mit Zwei-Faktor-Authentifizierung (TOTP) absichern →UsePAM yes: keyboard-interactive durchläuft den ganzen PAM-Stack, inklusive @include common-auth. Wer nur Schlüssel + Code will, kommentiert diese Zeile aus – mit der Konsequenz aus
der Warnung in Schritt 7.Der Code wird abgelehnt, obwohl die App ihn gerade anzeigt.
Meist läuft die Serveruhr
auseinander. TOTP toleriert nur wenige Sekunden. Prüfe
Nachlesen: SSH mit Zwei-Faktor-Authentifizierung (TOTP) absichern →timedatectl – System clock synchronized: yes muss dort stehen; sonst NTP aktivieren. Zweite Möglichkeit: Du hast denselben Code kurz zuvor
benutzt, und DISALLOW_REUSE verbietet das. Das gilt auch, wenn der vorige Versuch erst am
Passwort scheiterte – der Code war richtig und ist damit verbraucht. Derselbe Code wird
danach auch mit korrektem Passwort abgelehnt, erst der nächste geht durch. Also einfach den
nächsten abwarten.Nach drei Fehlversuchen geht gar nichts mehr.
Das ist die Ratenbegrenzung aus
Nachlesen: SSH mit Zwei-Faktor-Authentifizierung (TOTP) absichern →-r 3 -R 30: drei
Versuche pro 30 Sekunden. Dabei zählt jede Runde: Nach einem falschen Passwort fragt der
SSH-Client bis zu dreimal neu, und schon das schöpft das Limit aus. Kurz warten, statt weiter zu
tippen.Ein Benutzer kommt ohne Code rein.
Entweder fehlt seine
Nachlesen: SSH mit Zwei-Faktor-Authentifizierung (TOTP) absichern →~/.google_authenticator und nullok
lässt ihn passieren, oder für ihn greift ein Match-Block mit anderen AuthenticationMethods.
sudo sshd -T -C user=NAME,host=localhost,addr=127.0.0.1 | grep authenticationmethods zeigt, was für
ihn tatsächlich gilt.Handy verloren, keine Notfallcodes.
Dann hilft nur ein Zugang, der nicht über SSH läuft: die
VNC-Konsole beim Anbieter. Dort anmelden und die Datei des Benutzers löschen
(
Nachlesen: SSH mit Zwei-Faktor-Authentifizierung (TOTP) absichern →rm ~/.google_authenticator) – mit nullok kommt er dann wieder ohne Code herein, ohne es
entsteht ein Konto ohne zweiten Faktor, das du neu einrichten musst.Mails nach außen bleiben hängen, die Logs zeigen Timeouts auf Port 25.
Das liegt nicht an der
Software, sondern am Hoster: netcups Default-Policy „netcup Mail block" sperrt 25, 465 und 587
ausgehend. Die Policy nimmst du dem Server im SCP unter Firewall → Policys selbst ab – kein
Supportfall, kein Ticket. Betrifft Stalwart und Mailcow gleichermaßen, siehe
netcup-Firewall einrichten.
Nachlesen: Stalwart oder Mailcow? Zwei Mailserver im Vergleich →Die Mails kommen an, landen aber überall im Spam.
Dann fehlen Reverse-DNS (PTR), SPF, DKIM
oder DMARC. Auch das ist produktunabhängig und in
E-Mail-Zustellbarkeit Schritt für Schritt beschrieben.
Nachlesen: Stalwart oder Mailcow? Zwei Mailserver im Vergleich →Mailcow startet nicht, die Logs melden address already in use für Port 80 oder 443.
Auf dem
Server läuft bereits ein Reverse Proxy, und mailcows eigener nginx will dieselben Ports. Entweder
gibst du mailcow den Host für sich, oder du bindest seinen nginx wie unter „Was es kostet, neben
einen Reverse Proxy zu ziehen“ auf einen lokalen Port um und stellst ihn hinter den Proxy.
Nachlesen: Stalwart oder Mailcow? Zwei Mailserver im Vergleich →Nach dem Mailcow-Setup sind plötzlich alle anderen Container weg.
generate_config.sh hat auf
einem IPv6-Host die /etc/docker/daemon.json angelegt und Docker neu gestartet. Das ist gewolltes
Verhalten und verhindert ein offenes Relay, trifft aber eben den ganzen Host. Container mit
restart: unless-stopped kommen von allein zurück, alle anderen startest du von Hand.Das Mailprogramm warnt vor einem selbstsignierten Zertifikat CN=rcgen self signed cert.
Stalwart liefert noch seinen Platzhalter aus. Erst mit
Nachlesen: Stalwart oder Mailcow? Zwei Mailserver im Vergleich →docker compose logs traefik-certs-dumper nachsehen: Steht dort
/traefik/acme.json is not a file, zeigt der Pfad im Dumper nicht auf das Verzeichnis mit
Traefiks acme.json. Liegen die Dateien im Volume, fehlt nur das Neuladen – Actions → Reload →
TLS certificates oder ein Neustart von Stalwart; eingetragene Zertifikate werden erst danach
ausgeliefert.Container werden nach kurzer Zeit vom Kernel beendet (OOM).
Der Server ist für den gewählten
Stack zu klein. Bei Mailcow mit 18 Containern passiert das deutlich früher als bei Stalwart; als
erste Maßnahme schaltest du ClamAV in der
Nachlesen: Stalwart oder Mailcow? Zwei Mailserver im Vergleich →mailcow.conf mit SKIP_CLAMD=y ab, denn der
Virenscanner ist der größte Speicherfresser.Das Skript bricht beim Ermitteln der Flows mit IndexError: list index out of range ab.
Das
passiert nur direkt nach einer frischen Installation:
Nachlesen: Authentik Teil 2: Apps anbinden – Forward-Auth & OIDC →/-/health/ready/ meldet schon 200, während
der worker die mitgelieferten Abläufe noch einspielt. In diesem Moment gibt es oft erst einen
Flow, 20 bis 30 Sekunden später alle 15. Kurz warten und neu starten.Der Aufruf leitet auf http://localhost/application/o/authorize/… weiter.
Der eingebettete
Outpost kennt seine öffentliche Adresse nicht: Das Feld
Nachlesen: Authentik Teil 2: Apps anbinden – Forward-Auth & OIDC →authentik_host ist leer. Setz es auf
https://DEINE_DOMAIN/ (Schritt 3) – vorher landet jeder Nutzer auf einer toten Seite.Traefik antwortet mit 500 oder es kommt gar keine Weiterleitung.
Dann erreicht die Middleware den
Outpost nicht. Die
Nachlesen: Authentik Teil 2: Apps anbinden – Forward-Auth & OIDC →address muss aus Traefiks Sicht auflösbar sein – also der Dienstname aus der
Compose-Datei, den Docker im gemeinsamen Netz als Alias führt
(http://server:9000/outpost.goauthentik.io/auth/traefik), nicht localhost. Prüfe im Traefik-Ordner
mit docker compose exec traefik wget -S -qO- http://server:9000/-/health/live/; der Endpunkt liefert
einen leeren Rumpf, deshalb das -S – zu sehen sein muss HTTP/1.1 200 OK.Der Dienst ist geschützt, kennt aber den Benutzer nicht.
Es fehlt
Nachlesen: Authentik Teil 2: Apps anbinden – Forward-Auth & OIDC →authResponseHeaders an der
Middleware. Ohne diese Liste verwirft Traefik die Identitäts-Header aus Authentiks Antwort – die
Anmeldung funktioniert, die Anwendung sieht aber nichts.Nach der Anmeldung landet man in einer Weiterleitungsschleife.
Meist passt
Nachlesen: Authentik Teil 2: Apps anbinden – Forward-Auth & OIDC →external_host nicht
zur tatsächlich aufgerufenen Adresse (http statt https, mit oder ohne Subdomain). Er muss exakt die
URL sein, unter der Nutzer den Dienst aufrufen.Die OIDC-Anmeldung bricht mit „redirect_uri mismatch" ab.
Authentik prüft die Rückadresse strikt.
Trag im Provider genau die URI ein, die die Anwendung schickt – bei Grafana etwa
Nachlesen: Authentik Teil 2: Apps anbinden – Forward-Auth & OIDC →https://GRAFANA_DOMAIN/login/generic_oauth. Ein fehlender Schrägstrich reicht zum Scheitern.Alle angemeldeten Nutzer kommen überall rein.
Ohne Bindung an eine Gruppe ist eine Anwendung für
jeden angemeldeten Benutzer offen. Häng eine Gruppen-Bindung an die Anwendung (Schritt 8) und prüfe
mit einem Konto, das nicht in der Gruppe ist.
Nachlesen: Authentik Teil 2: Apps anbinden – Forward-Auth & OIDC →Authentik: Die Seite antwortet mit 403 Forbidden.
Die Sperre aus Schritt 2 lässt deine Adresse nicht
durch. Meist fehlt die IPv6 oder sie hat sich geändert – frag beide Adressen erneut ab (siehe dort),
korrigiere
Nachlesen: Authentik: Single Sign-On für alle Dienste (Teil 1) →sourcerange und starte mit docker compose up -d neu.Die Oberfläche liefert Internal Server Error, der Container gilt aber als gesund.
Dann
kann Authentik seine Vorlagenverzeichnisse nicht lesen. Typisch für Server mit
Nachlesen: Authentik: Single Sign-On für alle Dienste (Teil 1) →UMASK 027:
mkdir erzeugt dort drwxr-x--- – der Container läuft als Benutzer 1000 und kommt nicht
hinein. Im Log steht PermissionError: [Errno 13] Permission denied: '/templates/if/error.html'. Behebe es mit chmod 755 media certs custom-templates im
Stack-Verzeichnis und starte neu.Die Seite antwortet minutenlang mit 404, obwohl die Container laufen.
Beim ersten Start laufen
über 550 Datenbank-Migrationen; solange gibt auch
Nachlesen: Authentik: Single Sign-On für alle Dienste (Teil 1) →/-/health/ready/ ein 404 zurück. Auf dem VPS 1000 war das
nach 105 Sekunden vorbei, der Einrichtungs-Flow noch einmal zehn bis 25 Sekunden später. docker logs -f authentik-server-1 zeigt den Fortschritt.Beim Aufruf des Setup-Flows kommt „Anfrage wurde verweigert".
Der Einrichtungs-Flow lässt sich
nicht direkt über
Nachlesen: Authentik: Single Sign-On für alle Dienste (Teil 1) →/if/flow/initial-setup/ aufrufen. Geh auf die Wurzel-Adresse
https://DEINE_DOMAIN/, von dort leitet Authentik korrekt weiter.Die Kachel „Arbeiter" zeigt 0.
Der
Nachlesen: Authentik: Single Sign-On für alle Dienste (Teil 1) →worker-Container läuft nicht oder erreicht die Datenbank
nicht. Ohne ihn bleiben E-Mails, geplante Aufgaben und Outpost-Verwaltung liegen – ohne
Fehlermeldung in der Oberfläche. Prüfe docker compose ps und die Logs des Workers.Traefik antwortet mit 404.
Es fehlt meist
Nachlesen: Authentik: Single Sign-On für alle Dienste (Teil 1) →traefik.http.services.authentik.loadbalancer.server.port=9000. Der Container lauscht auf 9000;
Port 9443 ist Authentiks eigenes HTTPS, das wir bewusst nicht nutzen.Nach einem Neuaufsetzen sind alle Sitzungen ungültig oder die Anmeldung schlägt fehl.
Dann hat
sich der
Nachlesen: Authentik: Single Sign-On für alle Dienste (Teil 1) →AUTHENTIK_SECRET_KEY geändert – etwa weil die .env neu erzeugt wurde. Der Schlüssel muss
über die Lebensdauer der Installation gleich bleiben; stell ihn aus dem Backup wieder her.Der Benutzername passt nicht.
Das beim Setup erzeugte Konto heißt
Nachlesen: Authentik: Single Sign-On für alle Dienste (Teil 1) →akadmin, nicht wie deine
E-Mail-Adresse. Wer sich mit der Adresse anmelden will, muss das im Identifikations-Stage des
Anmelde-Flows erlauben.In den Logs steht „middleware … does not exist" und der Dienst antwortet mit 404.
Fast immer
fehlt der Provider-Zusatz: Eine im File-Provider definierte Middleware heißt aus Sicht der
Docker-Labels
Nachlesen: Traefik härten: Security-Header, Rate-Limit & Co. →name@file. Ohne Zusatz sucht Traefik sie unter den Docker-Labels – und findet
nichts. Umgekehrt gilt dasselbe für name@docker.BasicAuth lehnt das richtige Passwort ab.
Die
Nachlesen: Traefik härten: Security-Header, Rate-Limit & Co. →$-Zeichen im bcrypt-Hash wurden von Docker
Compose als Variablen interpretiert. Im Compose müssen sie verdoppelt werden ($$2y$$05$$…).
Mit docker compose config siehst du den Wert, der wirklich ankommt.Das Rate-Limit scheint nicht zu greifen.
Sequenzielle
Nachlesen: Traefik härten: Security-Header, Rate-Limit & Co. →curl-Aufrufe sind zu langsam: Jeder
Prozess baut eine neue Verbindung auf, damit bleibst du unter dem Limit. Teste parallel, etwa mit
seq 40 | xargs -P 8 -I{} curl … – dann erscheinen die 429.Nach dem Setzen der IP-Allowlist bekommst du selbst 403.
Häufigster Grund: Du hast nur deine
IPv4 eingetragen, kommst aber per IPv6. Vergleiche
Nachlesen: Traefik härten: Security-Header, Rate-Limit & Co. →curl -4 und curl -6 gegen deine Domain und
trag beide Adressfamilien ein (siehe Schritt 5). Zweiter Grund: Traefik sieht nicht deine IP, sondern
die des davorstehenden Proxys (Cloudflare, Load-Balancer). Prüfe mit traefik/whoami, was in
X-Forwarded-For steht, und arbeite bei mehrstufigen Aufbauten mit
ipallowlist.ipstrategy.depth.Der Browser kommt trotz korrigierter Konfiguration nicht mehr per HTTP durch.
Das ist HSTS und
kein Fehler: Der Browser hat sich
Nachlesen: Traefik härten: Security-Header, Rate-Limit & Co. →max-age gemerkt und erzwingt HTTPS selbst dann, wenn dein Server
es nicht mehr anbietet. Zum Testen hilft ein privates Fenster oder ein anderer Browser – und deshalb
die Warnung zu preload oben.Dockge: Die Seite antwortet mit 403 Forbidden.
Die Sperre aus Schritt 2 lässt deine Adresse nicht
durch. Meist fehlt die IPv6 oder sie hat sich geändert – frag beide Adressen erneut ab (siehe
dort), korrigiere
Nachlesen: Dockge: Compose-Stacks im Browser verwalten →sourcerange und starte mit docker compose up -d neu.Traefik antwortet mit 404, obwohl der Container healthy ist.
Meist fehlt
Nachlesen: Dockge: Compose-Stacks im Browser verwalten →traefik.http.services.dockge.loadbalancer.server.port=5001. Dockge lauscht im Container auf
5001; ohne die Zeile rät Traefik. Prüfe außerdem, dass der Container im proxy-Netz hängt.Der Deploy bricht mit „no such file or directory" ab.
Host- und Container-Pfad des
Stacks-Verzeichnisses stimmen nicht überein. Es muss
Nachlesen: Dockge: Compose-Stacks im Browser verwalten →/opt/stacks:/opt/stacks gemountet und
DOCKGE_STACKS_DIR=/opt/stacks gesetzt sein – Dockge lässt den Docker-Daemon des Hosts arbeiten,
und der kennt nur Host-Pfade.Ein Stack ist sichtbar, aber alle Knöpfe fehlen.
Dann liegt er außerhalb von
Nachlesen: Dockge: Compose-Stacks im Browser verwalten →/opt/stacks,
und Dockge zeigt „Dieser Stack wird nicht von Dockge verwaltet." Verschiebe den Ordner wie in
Schritt 7 – Dockge übernimmt ihn nicht von selbst und legt auch keine Kopie an.Der Stack-Name wird abgelehnt.
Erlaubt sind nur Kleinbuchstaben, Ziffern, Bindestriche und
Unterstriche, weil daraus Ordner- und Compose-Projektname werden.
Nachlesen: Dockge: Compose-Stacks im Browser verwalten →Meine App scheitert mit
Stack name can only contain [a-z][0-9] _ - only, meine-app geht.Nach einem Neustart ist die Anmeldung weg.
Dann wurde
Nachlesen: Dockge: Compose-Stacks im Browser verwalten →./data nicht persistent gemountet –
dort liegen Datenbank und JWT-Secret. Prüfe, dass /opt/dockge/data existiert und im Compose
eingebunden ist.Die Oberfläche ist englisch, obwohl der Browser auf Deutsch steht.
Dockge richtet sich nach
dem Browser und fällt bei unbekannten Kombinationen auf Englisch zurück; in den Einstellungen
lässt sich die Sprache fest wählen.
Nachlesen: Dockge: Compose-Stacks im Browser verwalten →Audiobookshelf: Die Seite antwortet mit 403 Forbidden.
Die Sperre aus Schritt 3 lässt deine Adresse nicht
durch. Meist fehlt die IPv6 oder sie hat sich geändert – frag beide Adressen erneut ab (siehe
dort), korrigiere
Nachlesen: Audiobookshelf: Hörbücher & Podcasts selbst hosten →sourcerange und starte mit docker compose up -d neu.Die Bibliothek bleibt nach dem Anlegen leer.
Der erste Scan läuft nicht automatisch – das
ist kein Fehler, sondern Audiobookshelfs Verhalten. Klick in der Bibliotheksansicht auf
Bibliothek scannen. Bleibt sie danach leer, prüfe mit
Nachlesen: Audiobookshelf: Hörbücher & Podcasts selbst hosten →docker compose exec audiobookshelf ls -R /audiobooks, ob der Container die Dateien überhaupt
sieht, und mit ls -ln /opt/audiobookshelf/audiobooks, dass alles UID 1000 gehört.Aus vier MP3-Dateien werden vier Hörbücher statt vier Kapitel.
Die Dateien liegen direkt im
Autoren-Ordner statt in einem gemeinsamen Titel-Ordner. Audiobookshelf gruppiert nach
Nachlesen: Audiobookshelf: Hörbücher & Podcasts selbst hosten →Autor/Titel/ – Dateien in einen Unterordner mit dem Buchtitel legen und erneut scannen.Traefik antwortet mit 404, obwohl der Container läuft.
Meist fehlt
Nachlesen: Audiobookshelf: Hörbücher & Podcasts selbst hosten →traefik.http.services.abs.loadbalancer.server.port=80. Audiobookshelf lauscht im Container auf
80; ohne diese Zeile rät Traefik und trifft daneben. Prüfe außerdem, dass der Container
wirklich im proxy-Netz hängt.Die Adresse springt auf /audiobookshelf/.
Das ist normal: Das Frontend wird mit diesem
festen Router-Pfad ausgeliefert, und
Nachlesen: Audiobookshelf: Hörbücher & Podcasts selbst hosten →ROUTER_BASE_PATH ändert daran zur Laufzeit nichts, weil
der Pfad im Image eingebaut ist. https://DEINE_DOMAIN bleibt als Einstieg gültig.Nach dem Gerätewechsel ist die Oberfläche wieder englisch.
Die Sprachwahl liegt lokal im
Browser, nicht am Konto. Auf dem neuen Gerät einmal über den Benutzernamen →
Nachlesen: Audiobookshelf: Hörbücher & Podcasts selbst hosten →Language →
„Deutsch" setzen.Der Podcast wird nicht gefunden.
Die Suche fragt den iTunes-Katalog ab; ein Tippfehler oder
ein dort fehlender Eintrag führt zu „Keine Suchergebnisse". Nimm stattdessen die RSS-URL des
Podcasts – dasselbe Feld akzeptiert beides.
Nachlesen: Audiobookshelf: Hörbücher & Podcasts selbst hosten →WordPress: Die Seite antwortet mit 403 Forbidden.
Die Sperre aus Schritt 2 lässt deine Adresse nicht durch. Meist fehlt die IPv6 oder sie hat sich geändert – frag beide Adressen erneut ab (siehe dort), korrigiere
Nachlesen: WordPress mit Docker & Traefik sauber betreiben →sourcerange und starte mit docker compose up -d neu.Redirect-Schleife (ERR_TOO_MANY_REDIRECTS) oder Mixed-Content-Warnungen.
Die HTTPS-Erkennung fehlt. Prüfe, dass der
Nachlesen: WordPress mit Docker & Traefik sauber betreiben →WORDPRESS_CONFIG_EXTRA-Block mit HTTP_X_FORWARDED_PROTO und den $$-Zeichen exakt gesetzt ist (siehe Warnung in Schritt 2), und starte den WordPress-Container neu.WordPress startet nicht, meldet „Error establishing a database connection“.
Meist eine Race Condition oder ein Passwort-Mismatch. Prüfe, dass
Nachlesen: WordPress mit Docker & Traefik sauber betreiben →depends_on: condition: service_healthy gesetzt ist und WORDPRESS_DB_PASSWORD exakt MARIADB_PASSWORD entspricht. Logs: docker compose logs db.Der erste Start scheitert, obwohl später alles läuft.
Die Datenbank braucht beim allerersten Start einige Sekunden zur Initialisierung. Mit dem Healthcheck ist das abgedeckt; ohne ihn hilft ein erneutes
Nachlesen: WordPress mit Docker & Traefik sauber betreiben →docker compose up -d.Medien-Uploads schlagen bei großen Dateien fehl.
PHP begrenzt die Upload-Größe. Lege eine eigene
Nachlesen: WordPress mit Docker & Traefik sauber betreiben →uploads.ini an und mounte sie nach /usr/local/etc/php/conf.d/ mit z. B. upload_max_filesize = 64M und post_max_size = 64M.Nach einem Domainwechsel zeigt die Seite ins Leere.
WP_HOME/WP_SITEURL in der Compose-Datei stehen fest verdrahtet – bei einer neuen Domain dort anpassen und Container neu starten (die Werte überschreiben die Datenbank-Einstellung).Die Seite kommt nicht, Traefik antwortet mit 404, obwohl der Container läuft.
Der Healthcheck ist noch nicht
Nachlesen: linkding: Lesezeichen selbst hosten →healthy (siehe Schritt 2). Status prüfen mit docker compose ps oder docker inspect -f '{{.State.Health.Status}}' linkding-linkding-1; bleibt es dauerhaft auf unhealthy, verraten docker compose logs linkding den Grund.Das Anmeldeformular antwortet mit Forbidden (403) CSRF verification failed.
Die Login-Seite selbst lädt normal, aber Django hat die Herkunft der Anfrage nicht als vertrauenswürdig erkannt – typisch, wenn ein Proxy vor Traefik den
Nachlesen: linkding: Lesezeichen selbst hosten →Host-Header umschreibt oder linkding unter einem Unterpfad läuft. LD_CSRF_TRUSTED_ORIGINS: https://DEINE_DOMAIN ergänzen (mit https://, ohne Pfad und ohne abschließenden Schrägstrich) und docker compose up -d.Titel und Beschreibung werden nicht automatisch geholt.
Die Zielseite blockiert automatisierte Zugriffe oder antwortet zu langsam. Trage beides von Hand ein oder stelle das Bookmarklet auf Erkennung im Browser um (Schritt 5).
Nachlesen: linkding: Lesezeichen selbst hosten →Das Admin-Konto wurde nicht angelegt.
LD_SUPERUSER_NAME und LD_SUPERUSER_PASSWORD greifen nur beim ersten Start mit leerer Datenbank. Existiert data/db.sqlite3 schon, ändert eine spätere Anpassung nichts. Konto nachträglich anlegen: docker compose exec linkding python manage.py createsuperuser.Die API oder die Extension antwortet mit 401.
Entweder fehlt der Token, oder er ist falsch:
Nachlesen: linkding: Lesezeichen selbst hosten →{"detail":"Authentication credentials were not provided."} heißt, der Authorization-Header kam gar nicht an, {"detail":"Invalid token."} heißt, der Token stimmt nicht. Da ein Token nur einmal angezeigt wird, ist Neuerzeugen unter Settings → Integrations der schnellere Weg als Suchen. Als Server exakt https://DEINE_DOMAIN eintragen, ohne Pfad dahinter.Navidrome: Die Seite antwortet mit 403 Forbidden.
Die Sperre aus Schritt 3 lässt deine Adresse nicht durch. Meist fehlt die IPv6 oder sie hat sich geändert – frag beide Adressen erneut ab (siehe dort), korrigiere
Nachlesen: Navidrome: die eigene Musik streamen wie mit Spotify →sourcerange und starte mit docker compose up -d neu.Die Bibliothek bleibt leer.
Entweder liegen keine Dateien im gemounteten
Nachlesen: Navidrome: die eigene Musik streamen wie mit Spotify →music-Ordner, oder die Rechte stimmen nicht. Prüfe: docker compose logs --no-log-prefix | grep "Scanner:" zeigt tracksImported. Ist es überall 0, kontrolliere den Pfad und dass der music-Ordner UID 1000 gehört (siehe Benutzer & Rechte).Titel erscheinen unsortiert oder ohne Cover.
Die Metadaten der Dateien sind unvollständig – Navidrome sortiert nach Tags, nicht nach Dateinamen. Was es in einer Datei tatsächlich liest, zeigt dir
Nachlesen: Navidrome: die eigene Musik streamen wie mit Spotify →docker compose exec navidrome /app/navidrome inspect "/music/Künstler/Album/Titel.mp3": Unter rawTags stehen die Tags so, wie sie in der Datei stehen. Fehlen dort album oder albumartist, tagge die Dateien nach (z. B. mit Picard) und lass Navidrome erneut scannen.Neue Musik taucht nicht auf.
Der Scan läuft nur stündlich (
Nachlesen: Navidrome: die eigene Musik streamen wie mit Spotify →ND_SCANNER_SCHEDULE). Einen sofortigen Scan stößt du in der Weboberfläche über das Aktualisieren-Symbol oben rechts an, oder du wartest bis zum nächsten Intervall. Wurden die Dateien frisch hochgeladen, fehlt oft schlicht das chown -R 1000:1000 aus Schritt 2.Die App verbindet sich nicht.
Fast immer die Server-URL: Sie muss
Nachlesen: Navidrome: die eigene Musik streamen wie mit Spotify →https://DEINE_DOMAIN lauten (mit https://, ohne Pfad). Antwortet der ping.view-Aufruf aus Schritt 8 sauber, liegt es an den Zugangsdaten – seit Version 0.64.1 bremst Navidrome wiederholte Fehlanmeldungen über die Subsonic-API zusätzlich aus, nach mehreren Tippfehlern lohnt also eine kurze Pause.Wiedergabe stockt bei großen FLAC-Dateien mobil.
Die Bandbreite reicht nicht fürs Original. Setze für den Player deiner App ein Transcoding-Profil und eine Obergrenze (Schritt 9) – der Eintrag erscheint unter Players erst, nachdem sich die App einmal verbunden hat.
Nachlesen: Navidrome: die eigene Musik streamen wie mit Spotify →Container startet nicht: „unable to open database file“.
DB_NAME: /data/hc.sqlite fehlt oder der data-Ordner gehört nicht UID 1000. Pfad setzen und chown -R 1000:1000 /opt/healthchecks/data (siehe Warnung in Schritt 2).Der Container steht auf Restarting, die Domain liefert 404.
In
Nachlesen: Healthchecks: Cron-Jobs und Backups überwachen →docker compose logs steht (hc.api.E002) The hostname in settings.SITE_ROOT is not found in settings.ALLOWED_HOSTS. Trag in ALLOWED_HOSTS exakt den Hostnamen aus SITE_ROOT ein – ohne https:// – und starte mit docker compose up -d neu.Login schlägt mit 403 fehl (CSRF-Fehler beim Absenden).
Healthchecks hält die Anfrage dann für unverschlüsseltes HTTP, und Django lehnt das Formular ab, weil die Herkunft
Nachlesen: Healthchecks: Cron-Jobs und Backups überwachen →https://… nicht dazu passt. Das Image erkennt HTTPS am Header X-Forwarded-Proto, den Traefik mitschickt – fehlt er, etwa hinter einem anders konfigurierten Proxy, kommt dieser Fehler. Eine Variable CSRF_TRUSTED_ORIGINS hilft nicht: Healthchecks liest sie nicht aus.Der Check wird nicht „grün“, obwohl der Job läuft.
Prüfe, ob der
Nachlesen: Healthchecks: Cron-Jobs und Backups überwachen →curl-Ping wirklich ausgeführt wird und die richtige UUID trifft: curl -v https://DEINE_DOMAIN/ping/UUID sollte OK zurückgeben. Auf der Detailseite siehst du im Protokoll, ob und von welcher IP Pings ankommen.Ich bekomme keine Benachrichtigung bei „down“.
Es ist kein Integrations-Kanal zugewiesen, oder (bei E-Mail) fehlen die SMTP-Einstellungen. Unter „Integrations“ einen Kanal einrichten und dem Check zuweisen.
Nachlesen: Healthchecks: Cron-Jobs und Backups überwachen →Stirling-PDF: Die Seite antwortet mit 403 Forbidden.
Die Sperre aus Schritt 1 lässt deine Adresse nicht durch. Meist fehlt die IPv6 oder sie hat sich geändert – frag beide Adressen erneut ab (siehe dort), korrigiere
Nachlesen: Stirling-PDF: PDF-Werkzeugkasten auf dem eigenen Server →sourcerange und starte mit docker compose up -d neu.Die Seite kommt nicht (Traefik-404), obwohl der Container läuft.
Der Healthcheck ist noch nicht
Nachlesen: Stirling-PDF: PDF-Werkzeugkasten auf dem eigenen Server →healthy – Traefik leitet dann bewusst nicht. Nach dem Start 20–30 Sekunden warten; Status mit docker inspect -f '{{.State.Health.Status}}' stirling-stirling-pdf-1 prüfen. Erst wenn dort healthy steht, antwortet die Domain.Login mit admin/stirling scheitert.
Entweder wurde das Passwort schon geändert (dann das neue nutzen), oder die Konfiguration im
Nachlesen: Stirling-PDF: PDF-Werkzeugkasten auf dem eigenen Server →configs-Volume ist inkonsistent. Zum Zurücksetzen die Anwendung stoppen und die Nutzerkonfiguration im configs-Ordner prüfen; im Zweifel den Ordner leeren (Achtung: setzt alle Einstellungen zurück, danach gelten wieder die Standarddaten).Nach dem Passwortwechsel bin ich plötzlich abgemeldet.
Das ist kein Fehler: Stirling-PDF verwirft die Sitzung, sobald das Passwort neu gesetzt wurde. Einfach mit Benutzername
Nachlesen: Stirling-PDF: PDF-Werkzeugkasten auf dem eigenen Server →admin und dem neuen Passwort erneut anmelden.Eine neu hinzugefügte OCR-Sprache erscheint nicht.
Die Anwendung liest
Nachlesen: Stirling-PDF: PDF-Werkzeugkasten auf dem eigenen Server →/usr/share/tessdata beim Start ein. Nach dem Kopieren der .traineddata also docker compose restart ausführen – und prüfen, dass die Datei wirklich im gemounteten data-Ordner liegt und auf .traineddata endet.Office-Konvertierungen oder OCR fehlen komplett.
Dann läuft die
Nachlesen: Stirling-PDF: PDF-Werkzeugkasten auf dem eigenen Server →-ultra-lite-Variante des Images: Ihr fehlen LibreOffice und Tesseract, entsprechend sind die Werkzeuge ohne Funktion. Auf den Standard-Tag (stirlingtools/stirling-pdf:3.2.2) wechseln und docker compose up -d – der Preis dafür sind rund 2,5 GB mehr Image.Große Dateien führen zu Fehlern oder langer Wartezeit.
OCR und Konvertierung sind speicherintensiv. Auf einem kleinen VPS kann RAM knapp werden – dann entweder kleinere Dateien verarbeiten oder auf ein größeres Produkt wechseln.
Nachlesen: Stirling-PDF: PDF-Werkzeugkasten auf dem eigenen Server →Syncthing: Die Seite antwortet mit 403 Forbidden.
Die Sperre aus Schritt 2 lässt deine Adresse nicht durch. Meist fehlt die IPv6 oder sie hat sich geändert – frag beide Adressen erneut ab (siehe dort), korrigiere
Nachlesen: Syncthing: Dateien ohne Cloud synchronisieren →sourcerange und starte mit docker compose up -d neu.Der Container startet nicht / Neustart-Schleife mit permission denied.
Die Rechte am
Nachlesen: Syncthing: Dateien ohne Cloud synchronisieren →config- oder data-Ordner stimmen nicht. chown -R 1000:1000 /opt/syncthing/config /opt/syncthing/data und neu starten (siehe Warnung in Schritt 1).Der Browser meldet ein ungültiges Zertifikat, obwohl der Container läuft.
Der Healthcheck ist noch nicht
Nachlesen: Syncthing: Dateien ohne Cloud synchronisieren →healthy, deshalb kennt Traefik die Domain noch nicht und antwortet mit seinem Notzertifikat (mit curl -k käme eine 404). Bis zu 60 Sekunden nach dem Start abwarten, docker inspect -f '{{.State.Health.Status}}' syncthing-syncthing-1 prüfen und die Seite neu laden. Bleibt es dabei, sieh in docker compose logs nach, warum der Healthcheck fehlschlägt.Zwei Geräte verbinden sich nicht.
Prüfe drei Dinge: Ist Port 22000 (TCP+UDP) in beiden Firewalls offen – UFW auf dem Server und ggf. der netcup-Firewall im SCP? Hast du die ID auf beiden Geräten eingetragen (die Kopplung ist beidseitig)? Und stimmt die ID exakt (Buchstabendreher fallen leicht auf, weil eine Prüfsumme eingebaut ist)? Der Status „Getrennt“ mit korrekt eingetragenen IDs deutet fast immer auf den Firewall-Port.
Nachlesen: Syncthing: Dateien ohne Cloud synchronisieren →Ein Ordner bleibt bei „Synchronisiere 0 %" hängen.
Meist fehlt auf der Gegenseite die Bestätigung der Freigabe, oder die Ordner-ID stimmt nicht überein – sie muss auf beiden Geräten identisch sein. Prüfe außerdem die Schreibrechte im Zielordner.
Nachlesen: Syncthing: Dateien ohne Cloud synchronisieren →Nach dem Setzen des GUI-Passworts kein Zugriff mehr.
Passwort vergessen? Du kannst es in der
Nachlesen: Syncthing: Dateien ohne Cloud synchronisieren →config.xml (<gui>-Block) zurücksetzen, indem du die <user>- und <password>-Zeilen entfernst und Syncthing neu startest – danach ist die Oberfläche wieder ohne Login erreichbar (und du setzt es sofort neu).FreshRSS: Die Seite antwortet mit 403 Forbidden.
Die Sperre aus Schritt 1 lässt deine Adresse nicht durch. Meist fehlt die IPv6 oder sie hat sich geändert – frag beide Adressen erneut ab (siehe dort), korrigiere
Nachlesen: FreshRSS: der eigene RSS-Reader →sourcerange und starte mit docker compose up -d neu.Nach der Einrichtung begrüßt dich wieder Schritt 1 des Assistenten.
Abgeschlossen ist die Installation erst mit dem Klick auf „Installation fertigstellen“ im letzten Schritt – wer das Browserfenster vorher schließt, landet beim nächsten Aufruf erneut im Assistenten. Dann einfach noch einmal durchlaufen und diesmal bis zum Ende klicken. Um Dateirechte musst du dich dabei nicht kümmern: Das offizielle Image korrigiert Gruppe und Rechte des
Nachlesen: FreshRSS: der eigene RSS-Reader →data-Verzeichnisses bei jedem Start selbst – auch bei einem aus dem Backup zurückgespielten Ordner.Feeds werden nicht automatisch aktualisiert.
Prüfe zuerst, ob der Cron-Eintrag im Container überhaupt existiert:
Nachlesen: FreshRSS: der eigene RSS-Reader →docker compose exec freshrss crontab -l muss eine Zeile ausgeben, die mit deinen CRON_MIN-Minuten beginnt (13,43 * * * * …). Fehlt sie, war CRON_MIN beim Start nicht gesetzt – Variable ergänzen und docker compose up -d. Was der letzte Lauf gemacht hat, steht im Container unter /tmp/FreshRSS.log (docker compose exec freshrss tail /tmp/FreshRSS.log). Manuell anstoßen kannst du jederzeit mit docker compose exec -u www-data freshrss ./cli/actualize-user.php --user admin.Die Handy-App verbindet sich nicht und meldet einen Serverfehler.
Antwortet
Nachlesen: FreshRSS: der eigene RSS-Reader →https://DEINE_DOMAIN/api/greader.php mit 503 Service Unavailable!, fehlt der serverweite Schalter aus Schritt 6: Ohne den Haken bei „API-Zugriff erlauben“ unter Administration → Authentifizierung nützt auch ein gesetztes API-Passwort nichts. Mit beidem antwortet die API auf eine Anmeldung mit 200 und liefert ein Auth-Token zurück.Ein Feed aus dem eigenen Netz bleibt leer.
Seit 1.30 blockiert FreshRSS lokale Ziele; im Protokoll steht
Nachlesen: FreshRSS: der eigene RSS-Reader →URL is not allowed to be resolved bzw. Fetching this URL is not allowed, because the host’s IP is not in the allowlist. Lösung ist die Umgebungsvariable INTERNAL_HOST_ALLOWLIST (siehe Kasten oben) – oder dieselbe Liste unter Administration → Systemeinstellungen. Bleibt ein Feed aus dem öffentlichen Netz leer, ist die URL meist eine HTML-Seite statt des Feeds; suche im Seitenquelltext nach application/rss+xml.Nach einiger Zeit fehlen ältere Artikel.
Das ist die Archivierung, und sie ist absichtlich streng voreingestellt: FreshRSS hält Artikel drei Monate und höchstens 200 pro Feed vor, mindestens aber 50 – Favoriten und mit Label versehene Artikel bleiben unangetastet. Wer länger blättern will, erhöht die Werte unter Einstellungen → Archivierung oder pro Feed in dessen Einstellungen; die Datenbank wächst dann entsprechend.
Nachlesen: FreshRSS: der eigene RSS-Reader →systemctl start schlägt fehl, status zeigt status=203/EXEC.
systemd konnte das Programm aus
Nachlesen: systemd verstehen: Units, Journal & Timer (statt Cron) →ExecStart nicht ausführen; im Journal steht dazu Unable to locate executable. Entweder stimmt der Pfad nicht, oder der Datei fehlt das Ausführbar-Bit (chmod +x). Ohne führenden / sucht systemd nur in /usr/local/sbin:/usr/local/bin:/usr/sbin:/usr/bin (nachzusehen mit systemd-path search-binaries-default) – ein eigenes Skript unter /opt oder /root musst du deshalb mit absolutem Pfad eintragen.systemd warnt „The unit file, source configuration file or drop-ins of … changed on disk".
Du hast eine Unit-Datei bearbeitet, aber systemd liest Änderungen nicht automatisch. Nach jeder Änderung an
Nachlesen: systemd verstehen: Units, Journal & Timer (statt Cron) →/etc/systemd/system/ gilt: systemctl daemon-reload.Der Timer taucht in list-timers nicht auf.
Er wurde nicht aktiviert.
Nachlesen: systemd verstehen: Units, Journal & Timer (statt Cron) →systemctl enable --now DIENST.timer – und daran denken, dass der Timer den Service auslöst, du also beide Dateien brauchst (.service und .timer).systemctl enable antwortet „The unit files have no installation config".
Der Unit fehlt der Abschnitt
Nachlesen: systemd verstehen: Units, Journal & Timer (statt Cron) →[Install] mit WantedBy=; in systemctl status erkennst du sie am static in der Loaded:-Zeile. Ohne [Install] weiß systemd nicht, wann die Unit automatisch starten soll – bei Timern gehört WantedBy=timers.target hinein.Das Journal ist riesig / frisst Platz.
Standardmäßig wächst es begrenzt, aber du kannst es beschneiden:
Nachlesen: systemd verstehen: Units, Journal & Timer (statt Cron) →journalctl --vacuum-time=14d löscht Einträge älter als 14 Tage, journalctl --disk-usage zeigt den Verbrauch.„Host validation failed" statt Dashboard.
Die häufigste Stolperfalle:
Nachlesen: Homepage: Dashboard für deine selbstgehosteten Dienste →HOMEPAGE_ALLOWED_HOSTS fehlt oder enthält die falsche Domain. Genau die Domain eintragen, unter der du zugreifst, dann docker compose up -d.Die Ressourcen-Widgets zeigen keine oder falsche Werte.
CPU und RAM liest Homepage aus dem Container heraus (kein Socket nötig). Zeigt
Nachlesen: Homepage: Dashboard für deine selbstgehosteten Dienste →disk: / das Container-Dateisystem statt der Host-Platte, binde den gewünschten Pfad zusätzlich als Volume ein (z. B. - /:/host:ro und disk: /host).Ein Icon wird nicht geladen.
Der Name passt nicht zum Icon-Katalog. Schreibe den Dienstnamen klein und ohne Leerzeichen (
Nachlesen: Homepage: Dashboard für deine selbstgehosteten Dienste →nextcloud.png), oder lege ein eigenes Bild in den icons-Ordner (gemountet nach /app/public/icons) und referenziere es als /icons/name.png. Neue eigene Bilder findet Homepage erst nach docker compose restart, bis dahin liefert der Pfad einen 404.Die Container-Kachel zeigt keinen Status.
Der Wert bei
Nachlesen: Homepage: Dashboard für deine selbstgehosteten Dienste →container: muss der exakte Container-Name sein. Finde ihn mit docker ps --format '{{.Names}}' – bei Compose ist das meist ordner-dienst-1 (z. B. traefik-traefik-1).Änderungen an den YAML-Dateien greifen nicht.
Geht es um Titel oder Layout aus der
Nachlesen: Homepage: Dashboard für deine selbstgehosteten Dienste →settings.yaml, fehlt meist nur der Klick auf das Aktualisieren-Symbol unten rechts (siehe Schritt 8). Sonst bricht oft ein Syntaxfehler das Einlesen ab. YAML ist einrückungsempfindlich – prüfe die Logs mit docker compose logs homepage auf error-Zeilen und achte auf konsequente Leerzeichen (keine Tabs).Statt der Anmeldemaske kommt „Authentication error – Auth is disabled or misconfigured".
Dann ist
Nachlesen: Homepage: Dashboard für deine selbstgehosteten Dienste →HOMEPAGE_AUTH_ENABLED gesetzt, aber Secret oder Passwort kommen leer im Container an – meist, weil die .env im falschen Ordner liegt oder eine Zeile daraus fehlt. Im Log steht dazu Password auth is enabled but required settings are missing; docker compose config zeigt dir, welche Werte Compose wirklich einsetzt.Der Container bleibt unhealthy.
Fast immer der IPv6-Fallstrick aus Schritt 4: Der Healthcheck fragt
Nachlesen: Die eigene Website mit Hugo hosten →localhost ab, nginx lauscht aber nur auf IPv4. Auf http://127.0.0.1/ umstellen. Prüfen mit docker inspect --format '{{.State.Health.Status}}' CONTAINER.Traefik zeigt 404 page not found (statt deiner Seite).
Das ist die Traefik-404, nicht die von nginx – Traefik findet keinen passenden Router. Häufigste Ursachen: Der Container ist noch nicht
Nachlesen: Die eigene Website mit Hugo hosten →healthy, die Host()-Regel enthält die falsche Domain, oder das proxy-Netz ist nicht external. Siehe das 502/404-Kapitel in Docker-Netzwerke verstehen.Alle Links und Bilder sind kaputt.
Die
Nachlesen: Die eigene Website mit Hugo hosten →baseURL in hugo.toml stimmt nicht mit der echten Domain überein. Hugo backt absolute URLs auf Basis dieses Werts ein – korrigieren und neu bauen.Ein Beitrag erscheint nicht.
Prüfe das
Nachlesen: Die eigene Website mit Hugo hosten →date im Front Matter: Liegt es in der Zukunft, baut Hugo den Beitrag nicht (siehe Warn-Box in Schritt 3). Auch ein draft: true versteckt Inhalte im normalen Build.module "PaperMod" not found in "/src/themes/PaperMod" beim Build.
Der Theme-Ordner fehlt im Build-Kontext – meist, weil er ein Git-Submodul ist, das nicht mitkopiert wurde, oder eine
Nachlesen: Die eigene Website mit Hugo hosten →.dockerignore ihn ausschließt. Theme wie in Schritt 1 als echten Ordner ablegen.Container erreicht anderen nicht per Name (bad address).
Beide hängen nicht im selben benannten Netz, oder einer nutzt das Standard-
Nachlesen: Docker-Netzwerke verstehen: bridge, DNS & proxy-Netz →bridge (kein DNS). Prüfe mit docker inspect -f '{{range $k,$v := .NetworkSettings.Networks}}{{$k}} {{end}}' CONTAINER, in welchen Netzen ein Container hängt.Traefik gibt 502 Bad Gateway.
Fast immer sind Traefik und die App in verschiedenen
Nachlesen: Docker-Netzwerke verstehen: bridge, DNS & proxy-Netz →proxy-Netzen, weil das Netz doppelt angelegt wurde. external: true im Compose sicherstellen und mit docker network inspect proxy prüfen, ob beide Container gelistet sind.network proxy declared as external, but could not be found beim up.
Das externe Netz existiert noch nicht. Einmalig anlegen:
Nachlesen: Docker-Netzwerke verstehen: bridge, DNS & proxy-Netz →docker network create --ipv6 --subnet fd00:cafe::/64 proxy. Lass Traefik das Netz nicht selbst erzeugen – dann entsteht es ohne IPv6, und hinter dem Proxy steht bei IPv6-Besuchern die Gateway-Adresse statt der echten IP.Datenbank hat trotz internal Internet.
Sie hängt zusätzlich in einem nicht-internen Netz (z. B.
Nachlesen: Docker-Netzwerke verstehen: bridge, DNS & proxy-Netz →proxy). Ein Container hat die Summe der Zugriffe aller seiner Netze – die DB gehört nur ins interne Netz, nie ins proxy-Netz.Zwei Stacks kollidieren beim Subnetz.
Docker vergibt
Nachlesen: Docker-Netzwerke verstehen: bridge, DNS & proxy-Netz →172.x-Bereiche automatisch, aber bei vielen Netzen kann der Pool knapp werden (could not find an available, non-overlapping IPv4 address pool). Ungenutzte Netze aufräumen: docker network prune.Permission denied, obwohl die Rechte stimmen.
Prüfe die Rechte des übergeordneten Verzeichnisses: Fehlt dort das
Nachlesen: Linux-Benutzer, Gruppen & Dateirechte verstehen →x-Recht, kommst du gar nicht erst an die Datei heran, egal wie ihre eigenen Rechte aussehen. ls -ld /pfad/zum/ordner zeigt es.docker ps sagt weiter „permission denied“ nach usermod -aG docker.
Die neue Gruppe ist in der aktuellen Sitzung noch nicht aktiv – aus- und wieder einloggen (siehe Warn-Box in Schritt 7).
Nachlesen: Linux-Benutzer, Gruppen & Dateirechte verstehen →id in der neuen Sitzung muss docker anzeigen.Neue Dateien haben unerwartete Rechte.
Das bestimmt die
Nachlesen: Linux-Benutzer, Gruppen & Dateirechte verstehen →umask – sie zieht Rechte von den Vorgaben ab. Auf Debian 13 hat root 0022 (Dateien 644, Verzeichnisse 755), normale Benutzer mit eigener Gruppe haben 0002 (664 und 775). Prüfen mit dem Befehl umask (ohne Argument).Ein Container schreibt nicht ins Volume.
Der Prozess im Container läuft unter einer bestimmten UID (oft nicht root). Setze den Besitzer des Host-Verzeichnisses passend:
Nachlesen: Linux-Benutzer, Gruppen & Dateirechte verstehen →chown -R 1000:1000 ./data – die richtige UID nennt die Doku des Images (Umgebungsvariablen wie PUID/PGID).usermod hat den Benutzer aus Gruppen geworfen.
Du hast
Nachlesen: Linux-Benutzer, Gruppen & Dateirechte verstehen →-G ohne -a benutzt. -G ersetzt die Nebengruppen. Immer usermod -aG verwenden. Reparatur: die fehlenden Gruppen mit usermod -aG gruppe1,gruppe2 benutzer wieder ergänzen.Die deutsche Suche liefert nach dem Modellwechsel wirre Treffer.
Die Fotos sind noch (oder teilweise) mit dem alten Modell indexiert – alte und neue Vektoren vertragen sich nicht. Unter Server-Tasks → Intelligente Suche den Lauf Alle starten und abwarten, bis die Warteschlange leer ist. Genau dieser gemischte Zustand entsteht auch, wenn du nur speicherst und den Neu-Index vergisst.
Nachlesen: Immich optimieren: Handy-Backup & KI-Suche (Teil 2) →Mit einem nllb-…-Modell ist die Suche nicht besser als vorher.
Die Sprachangabe, die diese Modelle erwarten, bietet Immich nicht an (siehe Warn-Box in Schritt 3). Auf ein
Nachlesen: Immich optimieren: Handy-Backup & KI-Suche (Teil 2) →XLM-…- oder SigLIP2-Modell wechseln und neu indexieren.Der ML-Container beendet sich nach dem Modellwechsel mit exit 137.
Out of Memory: Das neue Modell passt nicht mehr neben Server, Datenbank und deine übrigen Dienste. Entweder ein kleineres Modell wählen oder mehr RAM – das XLM-Basis-Modell braucht im Betrieb rund 1 GB nur für den ML-Container.
Nachlesen: Immich optimieren: Handy-Backup & KI-Suche (Teil 2) →Die externe Bibliothek bleibt nach dem Scan leer.
Fast immer stimmt der Pfad nicht: Als Importpfad gehört der Container-Pfad (
Nachlesen: Immich optimieren: Handy-Backup & KI-Suche (Teil 2) →/mnt/archiv) hinein, nicht der Host-Pfad. Prüfe mit docker compose exec immich-server ls /mnt/archiv, ob der Container die Dateien überhaupt sieht – kommt dort nichts, fehlt der Volume-Eintrag oder das docker compose up -d nach der Änderung.Das Handy sichert nur, wenn die App offen ist.
Auf Android killt die Akku-Optimierung den Hintergrund-Dienst (App ausnehmen, siehe Schritt 1); auf iOS fehlt die Hintergrundaktualisierung oder iOS priorisiert die App herunter – öfter öffnen hilft tatsächlich. Und: Standardmäßig wird nur im WLAN gesichert – unterwegs „fehlen" Fotos also nur scheinbar.
Nachlesen: Immich optimieren: Handy-Backup & KI-Suche (Teil 2) →Browser meldet NET::ERR_CERT_AUTHORITY_INVALID, curl sagt self-signed certificate.
Der Server liefert das eingebaute Traefik-Notzertifikat (
Nachlesen: Wie HTTPS funktioniert und was Traefik dir abnimmt →TRAEFIK DEFAULT CERT) aus, weil die Ausstellung fehlschlug. Fast immer: Der A-/AAAA-Record zeigt auf die falsche IP (dig DEINE_DOMAIN prüfen) oder Port 80 ist in der Firewall zu – die HTTP-01-Challenge kommt nie an. Die genaue Ursache steht in den Traefik-Logs: docker compose logs traefik | grep -i acme.Im issuer steht ein Name mit (STAGING) davor, etwa (STAGING) Ersatz Emmer YR2.
Die Test-CA von Let’s Encrypt ist noch aktiv – Browser vertrauen ihr absichtlich nicht. Staging-Zeile aus der Traefik-Konfiguration entfernen,
Nachlesen: Wie HTTPS funktioniert und was Traefik dir abnimmt →acme.json leeren, Container neu starten (Details im Traefik-Tutorial).certificate has expired.
Die automatische Erneuerung scheitert seit mindestens 30 Tagen – gleiche Ursachenliste wie beim ersten Fehler, nur lange unbemerkt. Falls die Meldung nur auf einem Gerät auftaucht: dessen Systemuhr prüfen, TLS ist zeitkritisch.
Nachlesen: Wie HTTPS funktioniert und was Traefik dir abnimmt →Let’s Encrypt meldet too many certificates already issued.
Rate-Limit gerissen, meist durch Experimentier-Schleifen gegen die Produktiv-CA. Auf die Staging-CA wechseln, bis das Setup steht – und
Nachlesen: Wie HTTPS funktioniert und was Traefik dir abnimmt →acme.json ins Backup nehmen, statt Zertifikate neu auszustellen.unable to get local issuer certificate auf einem alten Client.
Dem System fehlt das Root-Zertifikat aus Schritt 3 – der Root Store ist veraltet. Auf Debian:
Nachlesen: Wie HTTPS funktioniert und was Traefik dir abnimmt →apt update && apt install ca-certificates.AdGuard Home: Die Seite antwortet mit 403 Forbidden.
Die Sperre aus Schritt 2 lässt deine Adresse nicht
durch. Meist fehlt die IPv6 oder sie hat sich geändert – frag beide Adressen erneut ab (siehe dort),
korrigiere
Nachlesen: AdGuard Home: Werbeblocker fürs ganze Netz →sourcerange und starte mit docker compose up -d neu.Der Container startet nicht, Log sagt „listen udp :53: bind: address already in use".
systemd-resolved (oder ein anderer DNS-Dienst) belegt Port 53. Stub-Listener abschalten wie in
Schritt 1, danach docker compose up -d erneut.docker compose up scheitert mit „cannot assign requested address" für 10.8.0.1.
Das
WireGuard-Interface
Nachlesen: AdGuard Home: Werbeblocker fürs ganze Netz →wg0 mit 10.8.0.1 existiert (noch) nicht – Docker kann den Port nicht an eine
nicht vorhandene Adresse binden. Zuerst das WireGuard-VPN
einrichten und wg0 hochfahren (ip -br addr show wg0 muss 10.8.0.1 zeigen), dann den Container
starten.Nach dem Setup ist die Weboberfläche nicht mehr erreichbar.
Im Assistenten wurde der Admin-Port
auf 80 (Vorschlag) statt auf 3000 gesetzt – Traefik leitet aber auf 3000. In
Nachlesen: AdGuard Home: Werbeblocker fürs ganze Netz →./conf/AdGuardHome.yaml unter http: die address auf 0.0.0.0:3000 korrigieren und docker compose restart.DNS filtert nicht, obwohl das Gerät verbunden ist.
Der Browser nutzt DNS-over-HTTPS (DoH)
und umgeht damit deinen Server komplett – Firefox und Chrome haben das teils standardmäßig aktiv. In
den Browser-Einstellungen „Sicheres DNS" / „DNS über HTTPS" deaktivieren. Prüfen kannst du das mit
Nachlesen: AdGuard Home: Werbeblocker fürs ganze Netz →dig @10.8.0.1 … (greift immer).Eine Website ist plötzlich kaputt (leere Seiten, fehlende Bilder, kein Login).
Overblocking –
eine Sperrliste blockt eine Domain, die die Seite wirklich braucht. Im Abfrageprotokoll die
gesperrte Domain suchen, per Rechtsklick/Menü freigeben (Ausnahme) oder die zu aggressive Liste
deaktivieren.
Nachlesen: AdGuard Home: Werbeblocker fürs ganze Netz →Der Runner startet neu und meldet „cannot ping the docker daemon … certificate is valid for docker, …, not fjr-docker".
Der DinD-Dienst heißt anders als
Nachlesen: Forgejo Actions: eigener CI/CD-Runner mit Docker →docker, aber sein TLS-Zertifikat
ist auf docker ausgestellt. Nenne den DinD-Service exakt docker (wie oben) und sprich ihn
über DOCKER_HOST: tcp://docker:2376 an – dann passt der Name zum Zertifikat.Der Job startet, scheitert aber beim actions/checkout mit einem Verbindungsfehler.
Der Runner
wurde mit einer internen Instanz-URL (
Nachlesen: Forgejo Actions: eigener CI/CD-Runner mit Docker →http://forgejo:3000) registriert. Die Job-Container im
DinD können diesen Namen nicht auflösen. Neu registrieren mit der öffentlichen URL
https://DEINE_DOMAIN (.runner-Datei im Volume vorher löschen oder das Volume neu anlegen).Der Runner erscheint gar nicht in der Übersicht / die Registrierung schlägt fehl.
Falscher oder
bereits verbrauchter Token, oder der Runner erreicht Forgejo nicht. Frischen Token holen (Schritt 1)
und prüfen, dass der Runner-Container
Nachlesen: Forgejo Actions: eigener CI/CD-Runner mit Docker →https://DEINE_DOMAIN erreicht (docker compose run --rm runner wget -qO- https://DEINE_DOMAIN/api/healthz).Ein Job bleibt ewig „wartend" (pending).
Kein Runner hat ein passendes Label. Der Workflow
nutzt
Nachlesen: Forgejo Actions: eigener CI/CD-Runner mit Docker →runs-on: docker, der Runner muss also das Label docker tragen. Labels beim Registrieren
prüfen; in der Runner-Übersicht werden die Labels je Runner angezeigt.actions/checkout findet die Action nicht.
Forgejo lädt Actions aus einem konfigurierten
Register (standardmäßig
Nachlesen: Forgejo Actions: eigener CI/CD-Runner mit Docker →data.forgejo.org). Ist der Server komplett vom Internet abgeschnitten,
schlägt das fehl. Ausgehenden HTTPS-Zugriff erlauben oder Actions in einem internen Register
spiegeln.mail-tester zeigt „reverse DNS does not match".
Der PTR-Eintrag fehlt, ist noch nicht propagiert
oder passt nicht zum A-Record. PTR im Provider-Panel auf
Nachlesen: E-Mail-Zustellbarkeit: SPF, DKIM, DMARC und PTR →mail.DEINE_DOMAIN setzen, mit dig -x
prüfen und sicherstellen, dass der Name vorwärts auf dieselbe IP zeigt.DKIM schlägt fehl (DKIM: FAIL oder „no signature").
Der DNS-Record ist falsch übernommen
(wirklich abgeschnittener Schlüssel, falscher Selector) oder noch nicht propagiert. Den Wert exakt
aus der Mailserver-UI kopieren, Selector im Record (
Nachlesen: E-Mail-Zustellbarkeit: SPF, DKIM, DMARC und PTR →SELECTOR._domainkey) mit dem im Server
konfigurierten abgleichen, dann dig gegenprüfen. Zwei Blöcke in Anführungszeichen sind dabei
normal, siehe Schritt 3.SPF „permerror" oder „too many DNS lookups".
Mehrere SPF-Records, oder zu viele
Nachlesen: E-Mail-Zustellbarkeit: SPF, DKIM, DMARC und PTR →include:-Verschachtelungen (Limit: 10 DNS-Lookups). Mit dig +short TXT DEINE_DOMAIN | grep spf1
prüfen, ob wirklich nur eine Zeile zurückkommt, auf einen SPF-Record konsolidieren und
unnötige include: entfernen.Mails an Outlook/Hotmail landen im Spam oder werden abgewiesen.
Eine harte Abweisung mit
Nachlesen: E-Mail-Zustellbarkeit: SPF, DKIM, DMARC und PTR →550 5.7.515 Access denied, sending domain … does not meet the required authentication level ist
kein Reputationsproblem, sondern Microsofts Authentifizierungsregel aus Schritt 7. Landen die Mails
dagegen nur im Junk-Ordner, ist Microsoft schlicht streng mit neuen IPs – dagegen hilft nur das
Aufwärmen aus Schritt 8.Deine IP steht auf einer Blockliste.
Die IP war vor dir bei einem Spammer, oder ein Postfach von
dir versendet Spam. Auf den gängigen Blocklist-Checkern prüfen, bei berechtigtem Fund über das
jeweilige Delisting-Formular entfernen lassen – und die Ursache (kompromittiertes Konto) abstellen.
Nachlesen: E-Mail-Zustellbarkeit: SPF, DKIM, DMARC und PTR →Die Weboberfläche auf Port 8080 antwortet nicht.
Der Container ist noch am Hochfahren oder Port
8080 ist belegt/geblockt.
Nachlesen: Stalwart: der schlanke Mailserver in einem Container →docker compose ps prüfen, docker compose logs lesen und
sicherstellen, dass die Firewall Port 8080 (und später 443)
durchlässt. Bleibt die Log-Ausgabe nach dem Setup komplett leer, steht das Log-Ziel noch auf Log
file. In der Konsole unter Settings → Telemetry → Tracers auf Console umstellen und neu
starten.Die erste Anmeldung scheitert mit „Client metadata documents are disabled“.
Du rufst den
Einrichtungs-Assistenten über HTTPS bzw. deinen Reverse Proxy auf. Solange Stalwart im
Bootstrap-Modus ist, klappt die Anmeldung nur über
Nachlesen: Stalwart: der schlanke Mailserver in einem Container →http://…:8080/admin, direkt per IP oder
über einen SSH-Tunnel auf localhost:8080.Die Anmeldung scheitert mit „Unknown client id“.
Du rufst die Konsole über
Nachlesen: Stalwart: der schlanke Mailserver in einem Container →http://…:8080 oder die IP-Adresse auf. Nach der Einrichtung klappt der Login nur unter
https://mail.DEINE_DOMAIN/admin, also mit dem Hostnamen aus dem Assistenten und per HTTPS.Ich habe das Bootstrap-Passwort verpasst.
Solange der Assistent nicht abgeschlossen ist, reicht
ein
Nachlesen: Stalwart: der schlanke Mailserver in einem Container →docker compose restart; Stalwart loggt danach ein neues Einmal-Passwort. Dauerhafter: Setze in der
compose.yaml ein STALWART_RECOVERY_ADMIN=admin:DEIN_PASSWORT unter environment: und starte
mit docker compose up -d neu. Damit hast du ein festes Recovery-Admin-Konto.Kein TLS-Zertifikat, die HTTPS-Adresse zeigt eine Warnung.
Entweder erreicht Let’s Encrypt
deinen Server nicht auf Port 443 (Stalwart nutzt die TLS-ALPN-01-Challenge über 443), oder einer
der fünf Hostnamen aus Schritt 1 fehlt im DNS. Das Log nennt den Schuldigen beim Namen:
Nachlesen: Stalwart: der schlanke Mailserver in einem Container →ACME authentication error … NXDOMAIN looking up A for autoconfig.DEINE_DOMAIN. Fehlende Records
nachtragen, Port 443 in der Firewall öffnen; Stalwart wiederholt die Zertifikatsanforderung
danach automatisch.Mails nach außen bleiben hängen, Logs zeigen Timeouts auf Port 25.
Dein Provider sperrt
ausgehenden SMTP-Verkehr. Bei netcup ist die Default-Policy „netcup Mail block" (Port 25/465/587)
schuld: Im SCP unter Firewall → Policys dem Server dieses netcup-Template abnehmen, ein
Ticket ist nicht nötig, siehe netcup-Firewall einrichten. Ohne das
ist keine Zustellung an fremde Server möglich.
Nachlesen: Stalwart: der schlanke Mailserver in einem Container →Andere Server nehmen deine Mails nicht an oder sie landen im Spam.
Fehlender oder falscher
PTR-Eintrag, kein SPF/DKIM/DMARC. Das ist kein Fehler von Stalwart, sondern Sache der
DNS-/Reputations-Konfiguration; siehe das Tutorial zur
E-Mail-Zustellbarkeit.
Nachlesen: Stalwart: der schlanke Mailserver in einem Container →Die Seite antwortet mit 403 Forbidden
(nur hinter Traefik). Die Sperre aus Schritt 4 lässt
deine Adresse nicht durch. Meist fehlt die IPv6 oder sie hat sich geändert – frag beide Adressen
erneut ab (siehe dort), korrigiere
Nachlesen: Eigener Mailserver mit Mailcow: Setup von Grund auf →sourcerange und starte mit docker compose up -d neu.Die Oberfläche zeigt nur Fatal error: … Failed opening required '/web/inc/app_info.inc.php'.
Der Generator lief ohne
Nachlesen: Eigener Mailserver mit Mailcow: Setup von Grund auf →umask 0022, etwa nach einem neuen SSH-Login oder auf einem Server, dessen
Standard-umask (z. B. nach einer Lynis-Härtung 027) strenger
ist. Die Datei bekommt dann die Rechte 640, und PHP im Container darf sie nicht lesen. Mit
chmod 644 data/web/inc/app_info.inc.php ist die Seite sofort wieder da; sauberer ist, den Ordner zu
löschen und Schritt 3 in einer Sitzung mit umask 0022 zu wiederholen, damit keine weitere Datei
betroffen ist.generate_config.sh bricht mit Cannot find command 'jq' ab.
Das Paket
Nachlesen: Eigener Mailserver mit Mailcow: Setup von Grund auf →jq fehlt. sudo apt install -y jq und den Generator erneut starten.Der Generator meldet „User declined to create daemon.json" und bricht ab.
Auf Hosts mit aktivem
IPv6 hast du die Frage nach der IPv6-fähigen Docker-Konfiguration mit
Nachlesen: Eigener Mailserver mit Mailcow: Setup von Grund auf →n beantwortet – ohne sie
läuft mailcow dort nicht, sonst droht ein offenes Relay. Lege /etc/docker/daemon.json mit
{"ipv6": true} an (Docker 28 und neuer), starte Docker mit sudo systemctl restart docker neu und
führe ./generate_config.sh erneut aus – oder bestätige die Frage beim zweiten Anlauf einfach mit
Enter, dann erledigt der Generator beides selbst.Die Webmail antwortet nur mit Unauthorized.
SOGo kennt deine Mail-Domain nicht: Es liest die
Domainliste ausschließlich beim Start und wurde nach dem Anlegen der Domain nicht neu gestartet – in
seinen Logs steht
Nachlesen: Eigener Mailserver mit Mailcow: Setup von Grund auf →No authentication sources defined - nobody will be able to login. Starte SOGo
über E-Mail → SOGo neustarten neu. Bleibt es dabei, hängt noch ein fehlgeschlagener Login im
Cache: docker compose restart memcached-mailcow sogo-mailcow.Kein Zertifikat, acme-mailcow startet immer wieder neu
(nur ohne Traefik). Let’s Encrypt erreicht deinen Server
nicht auf Port 80, oder der A-Record von
Nachlesen: Eigener Mailserver mit Mailcow: Setup von Grund auf →mail.DEINE_DOMAIN stimmt nicht. Prüfe mit docker compose logs acme-mailcow, ob der Hostname und die IP passen, und dass Port 80 durch UFW und die
netcup-Firewall offen ist.Mails nach außen werden nicht zugestellt, Logs zeigen Timeouts auf Port 25.
Dein Provider sperrt
ausgehenden SMTP-Verkehr (üblich als Spam-Schutz). Bei netcup ist es die Default-Policy „netcup Mail
block" (Port 25/465/587): Im SCP unter Firewall → Policys dem Server dieses netcup-Template
abnehmen – kein Support-Ticket nötig, Details in
netcup-Firewall einrichten. Ohne das kannst du keine Mails
an fremde Server senden – Empfang und lokale Zustellung funktionieren trotzdem.
Nachlesen: Eigener Mailserver mit Mailcow: Setup von Grund auf →Ports 80/443 lassen sich nicht binden (address already in use).
Auf dem Host läuft schon ein
Webserver oder Reverse Proxy (z. B. Traefik). Entweder kommt mailcow auf einen eigenen Server, oder
du stellst es wie in Schritt 4 hinter den Proxy. Die Mail-Ports liegen in beiden Fällen direkt am
Host.
Nachlesen: Eigener Mailserver mit Mailcow: Setup von Grund auf →Hinter Traefik lädt die Oberfläche nicht, der Browser meldet zu viele Weiterleitungen.
In der
Nachlesen: Eigener Mailserver mit Mailcow: Setup von Grund auf →mailcow.conf steht noch HTTP_REDIRECT=y. mailcows nginx leitet dann auch die Anfragen auf HTTPS
um, die Traefik ihm unverschlüsselt weiterreicht – im Kreis. HTTP_REDIRECT=n setzen und
docker compose up -d.Hinter Traefik zeigen Mailprogramme ein selbst signiertes Zertifikat.
Der Dumper hat nichts
geschrieben oder Postfix und Dovecot nicht neu gestartet.
Nachlesen: Eigener Mailserver mit Mailcow: Setup von Grund auf →docker compose logs certdumper zeigt,
woran es liegt: acme.json is not a file heißt falscher Pfad zu Traefiks Verzeichnis. Steht dort
kein Restarting container … was successful, stimmen die Namen in --restart-containers nicht –
vergleiche sie mit docker compose ps --format '{{.Name}}'.Container starten träge oder werden vom Kernel beendet (OOM).
Zu wenig RAM. Auf mindestens 6–8
GB gehen oder ClamAV in der
Nachlesen: Eigener Mailserver mit Mailcow: Setup von Grund auf →mailcow.conf (SKIP_CLAMD=y) deaktivieren – der Virenscanner ist der
größte Speicherfresser.Die App meldet „Cannot connect" oder der Web-Client bleibt leer.
Die
Nachlesen: ntfy: Push-Benachrichtigungen aufs Handy →NTFY_BASE_URL passt nicht
zur aufgerufenen Adresse. Sie muss exakt deine öffentliche HTTPS-URL sein
(https://ntfy.DEINE_DOMAIN, ohne Slash am Ende). Nach einer Änderung docker compose up -d
erneut ausführen.curl liefert HTTP 401 oder 403.
Bei
Nachlesen: ntfy: Push-Benachrichtigungen aufs Handy →deny-all sind fehlende oder falsche Zugangsdaten der
häufigste Fehler. Benutzer/Passwort prüfen (docker exec ntfy ntfy user list) und beim Senden -u BENUTZER:PASSWORT bzw. den Bearer-Token mitgeben. Ein 403 bedeutet, dass der Benutzer existiert,
aber keine Rechte auf dieses Thema hat – dann mit ntfy access Rechte vergeben.Nachrichten kommen im Browser an, aber nicht als Push aufs Handy, wenn der Tab zu ist.
Browser-Push braucht erteilte Benachrichtigungsrechte und einen aktiven Service Worker; das ist
unzuverlässig, sobald der Tab geschlossen ist. Für echtes „unterwegs"-Push die ntfy-App verwenden –
sie hält die Verbindung im Hintergrund.
Nachlesen: ntfy: Push-Benachrichtigungen aufs Handy →502 Bad Gateway von Traefik.
Der Container ist noch nicht bereit oder hört auf dem falschen
Port. Prüfe
Nachlesen: ntfy: Push-Benachrichtigungen aufs Handy →docker compose logs ntfy und dass das Label loadbalancer.server.port=80 gesetzt ist
– ntfy lauscht im Container auf Port 80 (NTFY_LISTEN_HTTP=":80").429 Too Many Requests bei vielen Nachrichten kurz hintereinander.
ntfy begrenzt standardmäßig
die Rate pro Absender, um Missbrauch zu verhindern. Bei einem privaten Server mit eigenen Skripten
stößt du selten daran – ein Schleifen-Skript ohne Pause aber schon. Nachrichten bündeln statt im
Sekundentakt zu feuern, oder die Limits gezielt über die
Nachlesen: ntfy: Push-Benachrichtigungen aufs Handy →NTFY_VISITOR_*-Umgebungsvariablen anheben
(in der ntfy-Doku unter „Rate limiting" beschrieben). NTFY_BEHIND_PROXY: "true" ist Voraussetzung,
damit das Limit pro echter IP statt pro Traefik-Container greift.Der Container schreibt, aber der Bind-Mount-Ordner auf dem Host bleibt leer.
Du hast einen
relativen Pfad benutzt, der woanders zeigt als gedacht, oder Docker hat den Pfad neu als leeren
Ordner angelegt. Bei
Nachlesen: Docker-Volumes vs. Bind-Mounts: wo die Daten liegen →docker run Bind-Mounts immer mit absolutem Pfad angeben
(/opt/app/config, nicht config). Existiert dieser Host-Pfad noch nicht, legt Docker ihn
stillschweigend als leeren Ordner an – prüfe also mit ls, dass du wirklich den richtigen erwischt
hast. In der compose.yaml sind ./-Pfade dagegen völlig in Ordnung – sie sind relativ zur
compose.yaml und damit eindeutig. Achtung außerdem: docker run -v config:/data (ohne / oder
./ davor) ist kein Bind-Mount, sondern legt ein Named Volume namens config an.Permission denied, sobald der Container in den Mount schreiben will.
Der Prozess im Container
läuft unter einer anderen UID als der Besitzer des Host-Ordners – typisch bei Bind-Mounts. Bei Named
Volumes tritt das selten auf (Docker setzt die Rechte). Bei Bind-Mounts den Ordner dem passenden
Benutzer geben (
Nachlesen: Docker-Volumes vs. Bind-Mounts: wo die Daten liegen →chown -R 1000:1000 /opt/app/data) oder per user: in der compose.yaml die UID
setzen, unter der der Container läuft.Docker-Volumes vs. Bind-Mounts: Nach docker compose down sind alle Daten weg.
Du hast
Nachlesen: Docker-Volumes vs. Bind-Mounts: wo die Daten liegen →docker compose down -v benutzt – das
-v löscht die Named Volumes mit. Für einen normalen Neustart ohne -v arbeiten. -v bewusst
nur einsetzen, wenn du wirklich bei null anfangen willst.docker system prune hat Daten gelöscht.
docker volume prune bzw. docker system prune --volumes entfernt Volumes, an denen gerade kein Container hängt. Bei docker volume prune sind
benannte Volumes standardmäßig geschützt – gelöscht werden nur anonyme Volumes; benannte
fallen erst mit --all/-a weg. (Bei docker system prune steuert -a/--all dagegen die
Images, nicht die benannten Volumes.) Ein weiteres starkes Argument fürs Benennen – ein
sk-demo-vol übersteht ein versehentliches docker volume prune, ein anonymes Volume nicht.
Trotzdem prune mit Volumes nur laufen lassen, wenn alle wichtigen Stacks aktiv sind, oder gezielt
mit docker volume rm entfernen.Matomo: Die Seite antwortet mit 403 Forbidden.
Die Sperre aus Schritt 3 lässt deine Adresse nicht
durch. Meist fehlt die IPv6 oder sie hat sich geändert – frag beide Adressen erneut ab (siehe dort),
korrigiere
Nachlesen: Matomo cookielos selbst hosten, ohne Consent-Banner →sourcerange und starte mit docker compose up -d neu.Der Browser zeigt einen Zertifikatsfehler oder 404 page not found.
Traefik hat das
Let’s-Encrypt-Zertifikat noch nicht geholt, oder der DNS-Record zeigt nicht auf den Server. Prüfe
mit
Nachlesen: Matomo cookielos selbst hosten, ohne Consent-Banner →dig statistik.DEINE_DOMAIN, dass die IP stimmt, und sieh in die Traefik-Logs. Den genauen
Container-Namen aus deinem Traefik-Setup findest du mit docker ps | grep traefik, dann docker logs <container-name> (bei uns z. B. docker logs traefik-traefik-1). Die HTTP-Challenge
scheitert, wenn Port 80 nicht von außen erreichbar ist – kontrolliere deine
Firewall und die
netcup-Firewall.Der Installer meldet SQLSTATE... Connection refused oder hängt bei der Datenbank.
MariaDB war
beim ersten Start noch nicht bereit. Gib der DB einen Moment und lade die Seite neu. Prüfe mit
Nachlesen: Matomo cookielos selbst hosten, ohne Consent-Banner →docker compose logs db, ob dort ready for connections steht. Erscheint stattdessen ein
Zugangsfehler, passen DB_PASSWORD in der .env und die bereits angelegte DB nicht mehr zusammen –
dann hilft ein sauberer Neustart mit docker compose down -v (Achtung: löscht die Daten) und
docker compose up -d.Warnung „Es sieht so aus, als ob die trusted_hosts-Einstellung nicht korrekt ist".
Matomo
prüft aus Sicherheitsgründen, unter welchem Hostnamen es aufgerufen wird. Die Warnung erscheint,
wenn du die Domain wechselst. Bestätige den korrekten Hostnamen über den Button in der Meldung –
Matomo trägt ihn dann in
Nachlesen: Matomo cookielos selbst hosten, ohne Consent-Banner →config/config.ini.php ein.Im Dashboard tauchen keine Besuche auf.
Der Tracking-Code fehlt, ist falsch eingebaut, oder du
besuchst deine Seite selbst (Matomo ignoriert dich, wenn deine IP ausgeschlossen ist). Öffne deine
Website in einem privaten Fenster und prüfe im Netzwerk-Tab, ob ein Request an
Nachlesen: Matomo cookielos selbst hosten, ohne Consent-Banner →matomo.php
rausgeht. In Matomo hilft Verwaltung → Diagnose → Tracking Fehlschläge.Das Dashboard lädt sehr langsam.
Die On-the-fly-Archivierung rechnet bei jedem Aufruf. Richte
den Archivierungs-Cron aus Schritt 8 ein und stelle die Berichterstellung auf Cron um.
Nachlesen: Matomo cookielos selbst hosten, ohne Consent-Banner →Der Container startet immer wieder neu (Restarting), im Log steht bind: address already in use.
Forgejos eingebauter SSH-Server will auf Port 22 lauschen, auf dem im Container schon der
mitgelieferte OpenSSH-Dienst sitzt. Setze
Nachlesen: Forgejo: der eigene Git-Server hinter Traefik →SSH_PORT und SSH_LISTEN_PORT beide auf denselben
Wert (hier 2222) – dann startet Forgejo sauber.Der Container braucht ewig, bis er healthy ist.
Docker führt den ersten Healthcheck standardmäßig
erst nach dem
Nachlesen: Forgejo: der eigene Git-Server hinter Traefik →interval (30 s) aus – der Container sieht also 30 s+ „ungesund" aus, obwohl Forgejo
längst in ~2 s bereit ist. Die Lösung steckt schon oben in der Compose: start_interval: 2s prüft
während der Startphase im 2-Sekunden-Takt und schaltet sofort auf healthy, sobald die App antwortet.
(Braucht Docker 25+ / Compose v2.20+ – auf Debian 13 gegeben.)Traefik liefert 502 Bad Gateway.
Fast immer der falsche Port: Forgejos Weboberfläche lauscht intern
auf 3000, deshalb muss
Nachlesen: Forgejo: der eigene Git-Server hinter Traefik →loadbalancer.server.port=3000 gesetzt sein und der Container im
proxy-Netz hängen.Klon-Links zeigen localhost oder den falschen Port.
Dann stimmen
Nachlesen: Forgejo: der eigene Git-Server hinter Traefik →ROOT_URL, SSH_DOMAIN oder
SSH_PORT nicht. Korrigiere die Werte in der Compose und starte mit docker compose up -d neu.SSH-Klon scheitert mit Permission denied (publickey).
Der SSH-Server läuft, aber dein
öffentlicher Schlüssel ist noch nicht im Konto hinterlegt (Schritt 6) – oder du hast den Port
Nachlesen: Forgejo: der eigene Git-Server hinter Traefik →2222
vergessen.HitKeep: Die Seite antwortet mit 403 Forbidden.
Die Sperre aus Schritt 2 lässt deine Adresse nicht
durch. Meist fehlt die IPv6 oder sie hat sich geändert – frag beide Adressen erneut ab (siehe
dort), korrigiere
Nachlesen: HitKeep: datenschutzfreundliche Web-Analytics →sourcerange und starte mit docker compose up -d neu.Die Live-Tracking-Prüfung bleibt auf „Wartet" / keine Treffer im Dashboard.
Prüfe im Browser (Entwicklertools → Netzwerk), ob
Nachlesen: HitKeep: datenschutzfreundliche Web-Analytics →hk.js überhaupt geladen wird und der
Sende-Request danach mit Status 2xx zurückkommt. Häufigste Ursachen: Das Snippet steckt nicht
im HTML, die in HitKeep angelegte Site-Domain passt nicht zum Hostnamen der besuchten Seite,
oder ein Ad-/Tracking-Blocker filtert den Aufruf. Da du unter deiner eigenen Domain hostest
(First-Party), greifen die meisten Blocker nicht – manche Listen kennen aber den Pfad hk.js.Alle Besucher kommen scheinbar von einer einzigen IP, Land und Provider stehen auf „(Unknown)".
Dann greift
Nachlesen: HitKeep: datenschutzfreundliche Web-Analytics →HITKEEP_TRUSTED_PROXIES nicht: Der angegebene Bereich enthält die IP deines Proxys
nicht, und HitKeep wertet nur noch Traefiks Container-IP aus. Prüfe mit
docker network inspect proxy, in welchem Subnetz der Proxy liegt – 172.16.0.0/12 deckt die
üblichen Docker-Netze ab – und starte den Stack neu (docker compose up -d). Danach zählt wieder
die echte Client-IP aus dem X-Forwarded-For-Header.Traefik liefert 404 oder 502.
Ein
Nachlesen: HitKeep: datenschutzfreundliche Web-Analytics →404 heißt meist, dass die Router-Regel nicht greift – prüfe, dass Host(...) deine echte
Domain enthält und der Container im proxy-Netz hängt. Ein 502 deutet auf den falschen Port:
HitKeep lauscht intern auf 8080, deshalb muss loadbalancer.server.port=8080 gesetzt sein.Nach dem Login landest du wieder auf der Anmeldeseite (Login-Schleife).
Das ist fast immer eine Diskrepanz bei
Nachlesen: HitKeep: datenschutzfreundliche Web-Analytics →HITKEEP_PUBLIC_URL: Der Wert muss exakt der Adresse
entsprechen, über die du HitKeep aufrufst (inklusive https://, ohne abschließenden Slash).
Korrigiere die Variable und starte den Container neu.Der Container startet nicht bzw. ist nicht healthy.
Sieh in die Logs:
Nachlesen: HitKeep: datenschutzfreundliche Web-Analytics →docker compose logs -f hitkeep. Ein fehlendes oder leeres
HITKEEP_JWT_SECRET ist eine typische Startbremse – erzeuge eines wie in Schritt 1 und trage
es ein.In wg show erscheint nie ein latest handshake.
Der UDP-Port ist nicht erreichbar oder
die Schlüssel passen nicht. WireGuard ist bei falschen Schlüsseln stumm – es gibt keine
Fehlermeldung, nur keinen Handshake. Prüfe:
Nachlesen: WireGuard-VPN: sicherer Zugang zum eigenen Server →sudo ufw status (Port 51820/udp offen?), die
netcup-Firewall (eingehend UDP 51820), den Endpoint im Client (richtige öffentliche IP?) und
dass privater und öffentlicher Schlüssel nicht vertauscht sind.Handshake ist da, aber im Full-Tunnel kommt kein Internet an.
Fast immer das Routing/NAT.
Ist
Nachlesen: WireGuard-VPN: sicherer Zugang zum eigenen Server →net.ipv4.ip_forward=1 gesetzt (sysctl net.ipv4.ip_forward)? Läuft Docker mit – oder ist
UFW aktiv –, greift die FORWARD-DROP-Falle aus dem Warnkasten oben; der häufigste Fehler ist
dann eine fehlende RELATED,ESTABLISHED-Regel, also ein blockierter Rückweg. Prüfe mit
sudo iptables -S FORWARD, ob beide PostUp-Regeln wirklich in der Kette stehen. Stimmt das
externe Interface im MASQUERADE (eth0 vs. etwas anderes)?Full-Tunnel steht, aber curl -s ifconfig.me zeigt deine eigene Adresse.
Ist es eine
IPv6-Adresse, fehlt
Nachlesen: WireGuard-VPN: sicherer Zugang zum eigenen Server →::/0 in den AllowedIPs des Clients – IPv6 umgeht dann den Tunnel
(IPv6-Leak). Ergänzen, Tunnel neu starten und mit curl -4 und curl -6 getrennt prüfen.Full-Tunnel steht, aber DNS-Anfragen laufen weiter am Tunnel vorbei (DNS-Leak).
Ohne
Nachlesen: WireGuard-VPN: sicherer Zugang zum eigenen Server →DNS =-Zeile fragt dein Gerät weiter die DNS-Server deines lokalen Netzes – im offenen WLAN sieht
der Betreiber also weiter, welche Domains du aufrufst. Prüfe unter Linux mit resolvectl status, welcher DNS-Server dem Interface wg0 zugeordnet ist, oder mach einen Leak-Test (z. B.
auf dnsleaktest.com): Tauchen dort fremde Resolver auf, trägst du in der Client-Konfig einen
echten Resolver ein (DNS = 1.1.1.1) – oder den Server selbst (10.8.0.1), falls dort ein
eigener DNS-Resolver läuft.Der Tunnel steht, aber große Übertragungen (SSH, HTTPS, Downloads) hängen oder brechen ab.
Ein MTU-Problem.
Nachlesen: WireGuard-VPN: sicherer Zugang zum eigenen Server →wg-quick setzt die MTU auf 1420; in manchen Netzen (DS-Lite, bestimmte
Mobilfunknetze) ist das noch zu hoch. Setz testweise MTU = 1412 oder 1280 in der
[Interface]-Sektion des Clients.wg-quick up meldet resolvconf: command not found.
Die
Nachlesen: WireGuard-VPN: sicherer Zugang zum eigenen Server →DNS =-Zeile braucht
resolvconf. Entweder sudo apt install openresolv installieren oder die DNS-Zeile
entfernen, wenn du den VPN-DNS nicht brauchst.Die Verbindung schläft ein, sobald das Handy kurz nichts sendet.
Der Client sitzt hinter
NAT/CGNAT.
Nachlesen: WireGuard-VPN: sicherer Zugang zum eigenen Server →PersistentKeepalive = 25 in der Client-Konfig hält die Verbindung offen.Deine Werte liegen deutlich unter unseren, besonders bei der CPU.
Ein VPS teilt sich die
physische CPU. Prüfe die Steal Time (
Nachlesen: netcup VPS 1000 G12 im Benchmark: wie schnell ist er? →vmstat 1, Spalte st) und top (Zeile %st). Ist
sie dauerhaft hoch, rechnen gerade Nachbarn auf demselben Host. Miss zu einer anderen Tageszeit
erneut, oft ist der Unterschied dann weg.Die Disk-Werte sind absurd hoch (z. B. „10 GB/s random read").
Dafür gibt es zwei Ursachen,
und beide musst du ausschließen. Entweder fehlt
Nachlesen: netcup VPS 1000 G12 im Benchmark: wie schnell ist er? →--direct=1, dann misst fio den Seiten-Cache
im RAM statt der NVMe. Oder du misst in /tmp. Das ist auf Debian 13 ein tmpfs und liegt
komplett im RAM, wogegen auch --direct=1 nichts ausrichtet; uns hat dieser Fehler 913.000
statt 101.000 IOPS angezeigt, also fast das Neunfache. Prüfe mit
findmnt --target . -no FSTYPE, worauf du misst: Steht dort tmpfs statt ext4, wechsle in
ein Verzeichnis auf der echten Platte wie /var/tmp.lsblk zeigt für vda die Spalte ROTA=1 („rotierend") – ist das eine Festplatte statt
NVMe?
Nein. Das ist ein Virtualisierungs-Artefakt: Der virtio-Treiber meldet die
virtuelle Disk pauschal als rotierend. Die gemessenen 100k+ IOPS und 4 GB/s beweisen, dass
echter Flash-Speicher dahintersteht.
Nachlesen: netcup VPS 1000 G12 im Benchmark: wie schnell ist er? →Der Download ist viel langsamer als 2 Gbit/s.
Miss gegen einen nahen, schnellen Server
(z. B. Falkenstein). Ein weit entferntes Ziel oder eine langsame Gegenstelle begrenzt die
Messung, nicht dein VPS. Ein einzelner
Nachlesen: netcup VPS 1000 G12 im Benchmark: wie schnell ist er? →curl-Stream schöpft zudem nicht immer die volle
Bandbreite aus.Jeder Lauf liefert andere Zahlen.
Normal, Benchmarks schwanken. Miss mehrfach, verwirf den
ersten Lauf als Aufwärmlauf und nimm den Median der übrigen. Bei uns lag genau dieser erste
Lauf beim Schreibtest um den Faktor drei daneben. Vergleiche außerdem nur gleiche
Tool-Versionen und Parameter miteinander.
Nachlesen: netcup VPS 1000 G12 im Benchmark: wie schnell ist er? →docker compose pull zieht kein neues Image, obwohl es eine neue Version gibt.
Dein Tag zeigt
auf eine feste Version (
Nachlesen: Den ganzen Docker-Stack sicher aktuell halten →:1.37.2) oder auf einen Major-Tag (:18), unter dem es nur ein neues
Major gäbe. pull holt nur, was derselbe Tag inzwischen zeigt. Für einen Versionssprung
musst du den Tag in der compose.yaml selbst anheben.Die App startet nach dem Update nicht mehr oder wirft Datenbank-Fehler.
Meist ein Breaking
Change oder eine fehlgeschlagene Migration. Prüfe
Nachlesen: Den ganzen Docker-Stack sicher aktuell halten →docker compose logs, gleiche mit den
Release-Notes ab. Tag auf die alte Version zurücksetzen und up -d; hat die neue Version die Daten
schon migriert, das Backup aus Schritt 3 einspielen.Diun meldet nichts, obwohl Updates existieren.
Prüfe, dass die Container das Label
Nachlesen: Den ganzen Docker-Stack sicher aktuell halten →diun.enable=true tragen und Diun den Socket lesen kann (DIUN_PROVIDERS_DOCKER=true, Socket
gemountet). Für neuere Versions-Tags braucht der Container zusätzlich diun.watch_repo=true –
ohne das sieht Diun nur Änderungen am exakt gepinnten Tag. Und: Was Diun beim ersten Mal
sieht, wird nur in die Datenbank geschrieben, nicht gemeldet (watch.firstCheckNotif ist
false) – zum Testen des Meldewegs einmalig DIUN_WATCH_FIRSTCHECKNOTIF=true setzen.Die Festplatte läuft voll, obwohl du regelmäßig docker image prune machst.
docker image prune räumt nur dangling Images ab, nicht die alten getaggten Versionen. Entferne sie gezielt
mit docker rmi <image>:<tag> oder – mit Bedacht – docker image prune -a. Auch der Build-Cache
(docker builder prune) kann wachsen.Beim Ziehen kommt toomanyrequests / ein Docker-Hub-Rate-Limit.
diun.watch_repo=true auf
vielen Images fragt viele Tags ab. Setz das Watch-Intervall seltener (z. B. einmal täglich) und
grenze mit diun.include_tags auf relevante Versionen ein, statt das ganze Repo abzuklopfen.Eine frisch gesetzte Sperre wirkt nicht, die IP bekommt weiter 200.
Bis zu einer Minute
warten – der Bouncer holt neue Entscheidungen erst nach dem Pull-Intervall (Schritt 4).
Nachlesen: CrowdSec: moderne, kollaborative Angriffsabwehr →cscli metrics show acquisition zeigt keine Zeile für die Log-Datei.
CrowdSec liest die
Logs nicht. Häufigste Ursache: Der Container startete, bevor die
Nachlesen: CrowdSec: moderne, kollaborative Angriffsabwehr →access.log existierte
(No matching files for pattern … in docker logs crowdsec, siehe Schritt 1) –
cd ~/crowdsec && docker compose restart behebt das. Prüfe sonst, dass Traefik wirklich nach
/var/log/traefik/access.log schreibt, dass beide Container denselben Host-Pfad einbinden und
dass die acquis.yaml genau diesen Pfad nennt.Nach dem Neustart von Traefik bekommt jede App 403 – auch du selbst.
Der Bouncer erreicht
die LAPI nicht; im Traefik-Log steht
Nachlesen: CrowdSec: moderne, kollaborative Angriffsabwehr →crowdsecQuery:unreachable mit der URL
http://crowdsec:8080/v1/decisions/stream. Prüfe mit docker ps, dass der crowdsec-Container
Up ist – sobald der nächste Pull klappt, gehen die Anfragen von allein wieder durch
(Hintergrund im Kasten in Schritt 3).CrowdSec sperrt lauter harmlose oder gar keine echten Besucher – die erkannte IP ist immer die deines CDNs.
Sitzt ein CDN wie Cloudflare vor Traefik, sieht Traefik nur dessen IP.
Dann die echte Client-IP aus dem
Nachlesen: CrowdSec: moderne, kollaborative Angriffsabwehr →X-Forwarded-For-Header lesen lassen: In der Middleware
forwardedHeadersTrustedIPs mit den CDN-Netzen füllen – sonst sperrst du am Ende das CDN.
Direkt an netcup (ohne CDN) ist hier nichts zu tun.docker compose up -d bei Traefik meldet einen Plugin-Fehler.
Traefik lädt das Plugin
beim Start aus dem Netz. Prüfe, dass der Server raus darf (die
netcup-Firewall sperrt ausgehend nur SMTP, UFW
ebenso wenig) und dass
Nachlesen: CrowdSec: moderne, kollaborative Angriffsabwehr →modulename und version exakt stimmen.CrowdSec sperrt nichts, obwohl die Angriffe in der access.log stehen – oder es sperrt 172.18.0.1.
Dann sieht Traefik die echte Absenderadresse gar nicht. Das passiert bei IPv6-Besuchern, wenn das
Nachlesen: CrowdSec: moderne, kollaborative Angriffsabwehr →proxy-Netz ohne IPv6 angelegt wurde: Docker ersetzt die Quelladresse dann durch die des Bridge-Gateways, in der access.log steht bei allen IPv6-Zugriffen dieselbe 172.x.x.x, und eine Sperre darauf trifft entweder niemanden oder alle. Leg das Netz mit --ipv6 neu an; die Anleitung dafür steht im Reverse Proxy mit Traefik.dd hat die falsche Festplatte überschrieben – Daten weg.
dd fragt nicht nach und
heißt nicht umsonst spöttisch „disk destroyer". Prüfe das Ziel (of=) immer vorher mit
lsblk, und verwechsle nie sda mit sdb. Es gibt kein Rückgängig – im Zweifel lieber
dreimal lesen.kill -9 hat einen Dienst beendet, aber die Datenbank ist danach beschädigt.
-9 gibt
dem Prozess keine Chance, sauber zu schließen. Nutze immer zuerst kill ohne -9 und gib
dem Prozess ein paar Sekunden. Erst wenn er wirklich hängt, folgt die harte Variante.rsync hat viel mehr kopiert (oder gelöscht) als erwartet.
Der abschließende
Schrägstrich entscheidet:
Nachlesen: Die wichtigsten Terminal-Befehle für deinen Server →rsync -a /quelle/ kopiert den Inhalt von quelle, rsync -a /quelle kopiert den Ordner mit hinein. Und --delete löscht im Ziel alles, was in der
Quelle fehlt. Erst mit -n testen, immer.Ein Werkzeug meldet „command not found".
Das Paket ist nicht installiert. Installiere es
(siehe Tipp-Box oben) oder prüfe den Namen. Manche Tools wie
Nachlesen: Die wichtigsten Terminal-Befehle für deinen Server →iotop brauchen zudem sudo,
um überhaupt Daten zu sehen.Nach tmux ist bei erneutem Login „alles weg".
Du hast eine neue Sitzung gestartet
statt dich anzuhängen.
Nachlesen: Die wichtigsten Terminal-Befehle für deinen Server →tmux ls listet laufende Sitzungen, tmux attach -t 0 hängt dich an
die erste. Nur tmux allein erzeugt jedes Mal eine frische.Jellyfin: Die Seite antwortet mit 403 Forbidden.
Die Sperre aus Schritt 4 lässt deine
Adresse nicht durch. Meist fehlt die IPv6 oder sie hat sich geändert – frag beide
Adressen erneut ab (siehe dort), korrigiere
Nachlesen: Jellyfin selbst hosten: eigener Medienserver →sourcerange und starte mit docker compose up -d neu.502 Bad Gateway beim Aufruf, obwohl der Container läuft.
Traefik erreicht den
Container, trifft aber den falschen Port. Jellyfin lauscht auf 8096 – prüfe das Label
Nachlesen: Jellyfin selbst hosten: eigener Medienserver →traefik.http.services.jellyfin.loadbalancer.server.port=8096 auf Tippfehler. Kommt
stattdessen nach ein paar Sekunden ein 504 Gateway Timeout, ist der Port nicht das
Problem, sondern das Netzwerk: Dann fehlt networks: [proxy], und Traefik läuft gegen eine
Adresse, die es gar nicht erreichen kann.Die Bibliotheken bleiben leer, obwohl Dateien da sind.
Fast immer ein Rechte-Problem.
Der Container läuft als
Nachlesen: Jellyfin selbst hosten: eigener Medienserver →1000:1000 (Schritt 4), die Medien müssen also diesem Benutzer
gehören: sudo chown -R 1000:1000 /mnt/media. Und: In Jellyfin muss der Container-Pfad
stehen (/media/filme), nicht der Host-Pfad. Danach im Dashboard oben auf „Alle
Bibliotheken scannen" klicken – unter Geplante Aufgaben heißt dieselbe Aufgabe
„Medien-Bibliothek scannen".Video ruckelt/puffert, docker stats zeigt Jellyfin bei ~100 % CPU.
Es wird
transcodiert. Unter Dashboard → Wiedergabe siehst du im Aktivitätsmonitor, ob
„Transcode" statt „Direct Play" steht. Stell die Client-Qualität auf Original, stell
exotische Codecs auf ein breit unterstütztes Format um, oder gib dem Server mehr (dedizierte)
Kerne.
Nachlesen: Jellyfin selbst hosten: eigener Medienserver →Nach einem Reboot ist die Mediathek weg und Jellyfin zeigt leere Ordner.
Der Block
Storage wurde nicht eingehängt – meist ein fehlender oder falscher
Nachlesen: Jellyfin selbst hosten: eigener Medienserver →fstab-Eintrag (Schritt
2). Prüfe mit df -h /mnt/media und sudo mount -a. Die Zeile muss die UUID verwenden,
nicht /dev/vdb1.Login-Seite lädt, aber die App findet den Server nicht / Links zeigen auf eine interne Adresse.
JELLYFIN_PublishedServerUrl fehlt oder ist falsch. Setz sie in der
compose.yaml auf https://jellyfin.DEINE_DOMAIN und starte mit docker compose up -d neu
(ein restart reicht nicht, damit die Environment-Änderung greift).Ein Target steht in Prometheus auf up = 0 bzw. „DOWN".
Prometheus erreicht den
Exporter nicht. Bei
Nachlesen: Monitoring mit Grafana & Prometheus: Live-Dashboards →cadvisor prüfe, dass er im selben monitoring-Netz läuft und Name
und Port exakt stimmen (cadvisor:8080). Beim node-Job prüfe den extra_hosts-Eintrag
am Prometheus-Service und das Target host.docker.internal:9100 – ohne beides findet
Prometheus den node-exporter im Host-Netz nicht. Nach Änderungen an der prometheus.yml
den Prometheus-Container neu starten: docker compose restart prometheus.Das cAdvisor-Dashboard zeigt teils „No data" oder cAdvisor startet nicht.
Fehlen die
Mounts oder
Nachlesen: Monitoring mit Grafana & Prometheus: Live-Dashboards →privileged: true, sieht cAdvisor die Container nicht. Kontrolliere den
cadvisor-Block (Mounts, devices: /dev/kmsg). Einzelne „No data"-Panels sind normal –
manche Metriken (etwa CPU-Drosselung) gibt es nur, wenn du den Containern CPU-Limits
gesetzt hast.Grafana lädt hinter Traefik nicht richtig – Login schlägt fehl oder das Layout ist kaputt.
Fast immer stimmt
Nachlesen: Monitoring mit Grafana & Prometheus: Live-Dashboards →GF_SERVER_ROOT_URL nicht. Sie muss exakt die öffentliche
Adresse sein (https://grafana.DEINE_DOMAIN). Prüfe außerdem, dass die Traefik-Label
loadbalancer.server.port=3000 gesetzt ist – Grafana lauscht intern auf 3000.Grafana zeigt in den Panels „No data", obwohl die Targets up sind.
Meist der
Zeitbereich. Ein frischer Stack hat noch keine Historie – stell oben rechts „Last 15
minutes" ein und warte ein paar Minuten, bis Daten aufgelaufen sind. Prüfe zudem, dass
beim Dashboard-Import die Prometheus-Datenquelle gewählt war.
Nachlesen: Monitoring mit Grafana & Prometheus: Live-Dashboards →Prometheus startet nicht, im Log steht permission denied für die prometheus.yml.
Der Server
ist gehärtet (
Nachlesen: Monitoring mit Grafana & Prometheus: Live-Dashboards →UMASK 027), und Prometheus darf seine Konfiguration nicht lesen. Mit
chmod 644 prometheus/prometheus.yml aus Schritt 3 beheben und docker compose restart prometheus.
Fehlt in Grafana die Datenquelle, gilt dasselbe für die datasource.yml.Der Speicherplatz auf dem Server wächst stetig.
Das ist die Prometheus-TSDB. Reduziere
Nachlesen: Monitoring mit Grafana & Prometheus: Live-Dashboards →--storage.tsdb.retention.time (z. B. auf 15d) oder überwache weniger Ziele. Das
prom_data-Volume wächst mit Anzahl der Metriken × Vorhaltezeit.Immich: Die Seite antwortet mit 403 Forbidden.
Die Sperre aus Schritt 3 lässt deine
Adresse nicht durch. Meist fehlt die IPv6 oder sie hat sich geändert – frag beide
Adressen erneut ab (siehe dort), korrigiere
Nachlesen: Immich selbst hosten: privates Foto-Backup →sourcerange und starte mit docker compose up -d neu.Uploads großer Videos brechen nach etwa einer Minute ab (Fehler 502 oder 499).
Traefiks
Nachlesen: Immich selbst hosten: privates Foto-Backup →readTimeout (Standard 60 s) greift. Setz ihn wie in Schritt 4 auf 600s (oder höher) und
starte Traefik neu. Das ist mit Abstand der häufigste Immich-hinter-Proxy-Fehler.Der immich-machine-learning-Container stürzt ab bzw. beendet sich mit „exit 137", Suche
und Gesichtserkennung funktionieren nicht.
Zu wenig RAM – der Container wurde vom System
beendet (Out of Memory). Gib dem Server mehr Speicher, oder deaktiviere ML, indem du
den Service
Nachlesen: Immich selbst hosten: privates Foto-Backup →immich-machine-learning aus der compose.yaml entfernst. Immich läuft dann
ohne Gesichtserkennung und intelligente Suche, aber Upload und Zeitleiste funktionieren
normal.Nach einem Update starten die Container nicht mehr oder melden Migrationsfehler.
Server, Machine-Learning und Datenbank müssen auf derselben Version laufen. Setz in der
Nachlesen: Immich selbst hosten: privates Foto-Backup →.env die neue IMMICH_VERSION und aktualisiere alle Container gemeinsam (docker compose pull && docker compose up -d). Ein Downgrade nach einer Migration ist nicht
möglich – nur ein Rücksetzen aus dem Backup.Immich zeigt „Wartungsmodus" / „Vorübergehend nicht verfügbar".
Immich v3 startet bei
bestimmten Datenbank-Zuständen in einen Wartungsmodus. Im Log (
Nachlesen: Immich selbst hosten: privates Foto-Backup →docker compose logs immich-server) steht dann eine URL mit einem einmaligen Token
(…/maintenance?token=…) – darüber meldest du dich am Wartungsmodus an und wählst „neu
starten" bzw. beendest ihn. Danach ist die normale Oberfläche wieder da.Container startet nicht, „permission denied" beim Datenbank- oder Upload-Verzeichnis.
UPLOAD_LOCATION oder DB_DATA_LOCATION haben die falschen Zugriffsrechte oder liegen auf
einem Netzlaufwerk. Lege beide auf einer lokalen Platte an und stelle sicher, dass Docker
hineinschreiben darf.Beim Login erscheint „Forbidden (403)" oder „CSRF verification failed".
PAPERLESS_URL
ist nicht oder falsch gesetzt. Sie muss exakt deiner HTTPS-Adresse entsprechen
(https://paperless.DEINE_DOMAIN, ohne Schrägstrich am Ende). Nach der Korrektur docker compose up -d.Dateien im Consume-Ordner werden nicht verarbeitet, „permission denied".
Häufigste
Ursache: Die Ordner wurden nicht vorab angelegt (Schritt 3), sondern beim ersten Start vom
Docker-Daemon erzeugt – dann gehören sie
Nachlesen: Paperless-ngx selbst hosten: papierloses Büro mit OCR →root. Mit sudo chown -R $(id -u):$(id -g) ~/paperless/consume ~/paperless/export gehören sie wieder dir. Ansonsten:
USERMAP_UID/USERMAP_GID passen nicht zum Besitzer des Ordners – ermittle deine Kennung
mit id -u und id -g, trag die Werte ein und starte neu.Hochgeladene Dokumente bleiben „in Bearbeitung" hängen.
Die Hintergrundverarbeitung läuft
über den Broker. Prüfe, dass der
Nachlesen: Paperless-ngx selbst hosten: papierloses Büro mit OCR →broker-Container läuft, und sieh unter Aufgaben nach
der Fehlermeldung der fehlgeschlagenen Aufgabe. Steht der broker dauerhaft auf
Restarting und im Log Can't handle RDB format version 15, hast du ein Redis-Volume an
Valkey gehängt – siehe „Läuft deine Instanz noch mit Redis?“ unter Wartung.Die Texterkennung liefert Unsinn oder erkennt nichts.
Falsche OCR-Sprache. Setz
Nachlesen: Paperless-ngx selbst hosten: papierloses Büro mit OCR →PAPERLESS_OCR_LANGUAGE=deu (oder deu+eng für gemischte Dokumente). Nur installierte
Sprachen funktionieren.Office-Dokumente (Word, Excel) werden nicht angenommen oder enden im Timeout.
Dafür sind
Gotenberg und Tika zuständig. Prüfe, dass beide Container laufen und
Nachlesen: Paperless-ngx selbst hosten: papierloses Büro mit OCR →PAPERLESS_TIKA_ENABLED=1 samt der beiden Endpoint-Variablen gesetzt ist.Beim Massenimport wird der Server sehr langsam, die CPU ist dauerhaft am Anschlag.
OCR
ist rechenintensiv, und Paperless nutzt standardmäßig alle Kerne. Auf kleinen Servern kannst
du die Last drosseln, indem du die Zahl der Worker bzw. Threads begrenzt
(
Nachlesen: Paperless-ngx selbst hosten: papierloses Büro mit OCR →PAPERLESS_TASK_WORKERS, PAPERLESS_THREADS_PER_WORKER). Dann dauert der Import länger,
aber die Oberfläche bleibt bedienbar.Nach dem Traefik-Neustart erscheint der HSTS-Header nicht in der curl-Ausgabe.
Meist
ist die Middleware nicht am Router. Prüfe, dass die Zeile
Nachlesen: Nextcloud absichern & optimieren (Teil 2) →traefik.http.routers.nc.middlewares beide Middlewares nennt (nc-dav,nc-secure) und
dass die zwei nc-secure-Header-Labels im nc-app-Block stehen. Danach docker compose up -d nc-app. Traefik übernimmt geänderte Labels erst beim Neu-Erstellen des Containers.Der E-Mail-Test schlägt fehl („Es gab ein Problem beim Senden der E-Mail").
Fast immer
Port/Verschlüsselung oder Authentifizierung. Kombiniere
Nachlesen: Nextcloud absichern & optimieren (Teil 2) →SSL/TLS mit Port 465 oder
Keine / STARTTLS mit Port 587, nicht kreuzweise. Nutzt dein Anbieter 2FA, brauchst du ein
App-Passwort (siehe Schritt 4). Details stehen im Nextcloud-Log: docker exec -u www-data nc-app php occ log:tail 20.Du kommst nach dem Erzwingen von 2FA selbst nicht mehr rein.
Du hattest noch keinen
zweiten Faktor eingerichtet. Hebe die Pflicht per Kommandozeile auf, richte deinen Faktor
in Ruhe ein und schalte sie danach wieder scharf:
Nachlesen: Nextcloud absichern & optimieren (Teil 2) →docker exec -u www-data nc-app php occ twofactorauth:enforce --off.Im Brute-Force-Kasten steht eine 172.x.x.x-Adresse statt deiner echten IP.
TRUSTED_PROXIES passt nicht zu den tatsächlichen proxy-Subnetzen. Lass dir beide
ausgeben – das Netz hat einen IPv6- und einen IPv4-Bereich – und trag sie durch ein
Leerzeichen getrennt in der nc-app-Umgebung ein (Teil 1, Schritt 2): docker network inspect proxy -f '{{ range .IPAM.Config }}{{ .Subnet }} {{ end }}'. Sonst sperrt der
Brute-Force-Schutz im Ernstfall den Proxy und damit alle Nutzer.Nach einem Reboot meldet Nextcloud „Redis went away" oder wird sehr langsam.
Der
App-Container ist vor Redis gestartet. Stelle sicher, dass
Nachlesen: Nextcloud absichern & optimieren (Teil 2) →nc-redis in depends_on
steht (Teil 1) und mit restart: unless-stopped läuft – dann fängt Docker den
Startreihenfolge-Fall selbst ab.Nextcloud: Die Seite antwortet mit 403 Forbidden.
Die Sperre aus Schritt 3 lässt deine
Adresse nicht durch. Meist fehlt die IPv6 oder sie hat sich geändert – frag beide
Adressen erneut ab (siehe dort), korrigiere
Nachlesen: Nextcloud selbst hosten: deine eigene Cloud →sourcerange und starte mit docker compose up -d neu.„Zugriff über eine nicht vertrauenswürdige Domäne" statt der Login-Seite.
Deine
Domain steht nicht in
Nachlesen: Nextcloud selbst hosten: deine eigene Cloud →trusted_domains. Prüfe NEXTCLOUD_TRUSTED_DOMAINS in der
Compose-Datei. Nachträglich setzen geht per occ: docker exec -u www-data nc-app php occ config:system:set trusted_domains 1 --value=cloud.DEINE_DOMAIN.Der Sicherheits-Check meldet „Your web server is not set up properly to resolve .well-known/caldav".
Der CalDAV/CardDAV-Redirect greift nicht. Kontrolliere die
Nachlesen: Nextcloud selbst hosten: deine eigene Cloud →nc-dav-Middleware-Labels (Schritt 3) und dass der Router sie über
...routers.nc.middlewares=nc-dav einbindet. Das Regex muss die volle https://…-URL
matchen – redirectregex prüft die komplette URL, nicht nur den Pfad.Warnung „The ‘Strict-Transport-Security’ HTTP header is not set".
Der HSTS-Header
fehlt. Setz ihn als Traefik-Middleware und häng sie an den Router:
Nachlesen: Nextcloud selbst hosten: deine eigene Cloud →traefik.http.middlewares.nc-secure.headers.stsSeconds=15552000. Häng sie zusätzlich zur
nc-dav-Middleware an den Router (...routers.nc.middlewares=nc-dav,nc-secure). Der
Header muss vom Proxy kommen, nicht von Nextcloud. In Teil
2 richten wir genau diese
nc-secure-Middleware vollständig ein (inklusive includeSubdomains).Große Uploads brechen ab oder enden mit einem Timeout / „413".
Das PHP-Limit ist zu
klein. Erhöhe
Nachlesen: Nextcloud selbst hosten: deine eigene Cloud →PHP_UPLOAD_LIMIT und PHP_MEMORY_LIMIT (Schritt 3) und starte den
Container neu. In seltenen Fällen greifen diese Variablen nicht – dann ein eigenes
php.ini-Snippet ins Image mounten.Beim ersten Start bricht die Installation mit „MySQL server has gone away" oder „Connection refused" ab.
Der App-Container war schneller als die Datenbank. Genau
dagegen ist der
Nachlesen: Nextcloud selbst hosten: deine eigene Cloud →healthcheck mit depends_on: condition: service_healthy da – prüfe,
dass beide in deiner Compose-Datei vorhanden sind, und starte mit docker compose up -d
neu.Uptime Kuma: Die Seite antwortet mit 403 Forbidden.
Die Sperre aus Schritt 1 lässt deine
Adresse nicht durch. Meist fehlt die IPv6 oder sie hat sich geändert – frag beide
Adressen erneut ab (siehe dort), korrigiere
Nachlesen: Uptime Kuma: Server-Monitoring hinter Traefik →sourcerange und starte mit
docker compose up -d neu.Bad Gateway (502) beim Aufruf von status.DEINE_DOMAIN.
Fast immer fehlt das
Port-Label
Nachlesen: Uptime Kuma: Server-Monitoring hinter Traefik →traefik.http.services.kuma.loadbalancer.server.port=3001 oder es steht
ein falscher Port drin. Traefik erreicht den Container dann zwar, klopft aber am
falschen Port an. Label prüfen und docker compose up -d erneut ausführen.404 page not found statt Kuma.
Wie bei jeder App hinter Traefik:
Nachlesen: Uptime Kuma: Server-Monitoring hinter Traefik →traefik.enable=true gesetzt? Container im proxy-Netzwerk? Stimmt die Domain in
der Host(...)-Regel und zeigt der DNS-Record status.DEINE_DOMAIN auf den Server?
Das Traefik-Dashboard zeigt unter „HTTP Routers", ob kuma registriert ist.Die Oberfläche lädt, aber die Live-Aktualisierung ruckelt / bricht ab.
Kuma nutzt
WebSockets. Traefik leitet die standardmäßig korrekt weiter – tritt das Problem
trotzdem auf, liegt es meist an einem davorgeschalteten CDN/Proxy (z. B. Cloudflare
im „Proxy"-Modus), der WebSockets blockt. Für den Direktbetrieb hinter Traefik ist
keine Zusatzkonfiguration nötig.
Nachlesen: Uptime Kuma: Server-Monitoring hinter Traefik →Nach einem Neuaufsetzen sind alle Monitore weg.
Das
Nachlesen: Uptime Kuma: Server-Monitoring hinter Traefik →kuma-data-Volume wurde
gelöscht (z. B. durch docker compose down -v). Alle Konfiguration und Historie
liegt allein in diesem Volume – deshalb steht es im nächsten Abschnitt ganz oben.Der Container beendet sich sofort wieder, das Log sagt No persistent volume!.
Es
fehlt das
Nachlesen: Vaultwarden: eigener Passwortmanager hinter Traefik →volumes:-Mapping. Vaultwarden bricht dann mit dem Kasten „It looks like you
did not configure a persistent volume!" ab und beendet sich mit Exit-Code 1, damit deine
Passwörter nicht in einem flüchtigen Container landen. Ergänze ./vw-data:/data wie in
Schritt 2 und starte neu.Die Web-Oberfläche zeigt „You need to enable HTTPS!" oder der Login scheitert mit Krypto-Fehlern.
Vaultwarden nutzt die Web-Crypto-API des Browsers, die nur in einem
sicheren Kontext (echtes HTTPS) verfügbar ist. Du hast die Seite über
Nachlesen: Vaultwarden: eigener Passwortmanager hinter Traefik →http:// oder
mit ungültigem Zertifikat aufgerufen. Stell sicher, dass Traefik ein gültiges
Let’s-Encrypt-Zertifikat geholt hat (Traefik-Log prüfen) und du die Seite über
https:// erreichst. Die DOMAIN-Variable muss ebenfalls mit https:// beginnen.Das Admin-Panel weist dein Passwort ab, obwohl es stimmt.
Vermutlich sind die
Dollarzeichen im
Nachlesen: Vaultwarden: eigener Passwortmanager hinter Traefik →ADMIN_TOKEN nicht verdoppelt. In der compose.yaml muss aus jedem
$ ein $$ werden. Prüfe mit docker compose exec vaultwarden printenv ADMIN_TOKEN,
wie der Token wirklich im Container ankommt – dort muss wieder ein einfaches $
stehen. (docker compose config hilft hier nicht: Es zeigt die Datei mit den doppelten
$$.) Denk auch daran: Beim Login gibst du das Passwort ein, nicht den Hash.Die Handy-App findet den Server nicht oder meldet „Server-URL ungültig".
Die
Server-URL muss die vollständige
Nachlesen: Vaultwarden: eigener Passwortmanager hinter Traefik →https://-Adresse ohne abschließenden Pfad sein
(https://vault.DEINE_DOMAIN). Prüfe außerdem, ob die Domain von außen per Browser
erreichbar ist und das Zertifikat gültig ist – Apps sind bei Zertifikatsfehlern strenger
als Browser.Trotz SIGNUPS_ALLOWED=false konnte sich jemand registrieren.
Wahrscheinlich wurde
die Einstellung im Admin-Panel gesetzt und überschreibt die Umgebungsvariable, oder der
Container wurde nach der Änderung nicht neu gestartet. Kontrolliere den Wert unter
Settings → General settings im Panel und starte mit
Nachlesen: Vaultwarden: eigener Passwortmanager hinter Traefik →docker compose up -d neu.Der Probelauf meldet No packages found that can be upgraded unattended.
Meist
völlig normal – aktuell steht kein Sicherheitsupdate an. Prüfe die Konfiguration
trotzdem über die
Nachlesen: Automatische Sicherheitsupdates mit unattended-upgrades →Allowed origins are:-Zeile im --debug-Lauf. Erscheinen dort
keine Security-Origins, stimmt das Origins-Pattern aus Schritt 3 nicht.Updates kommen, aber der Server startet trotz Kernel-Update nie neu.
Meist steht
Nachlesen: Automatische Sicherheitsupdates mit unattended-upgrades →Automatic-Reboot auf "false" (Standard) – dann auf "true" setzen und eine
Automatic-Reboot-Time vergeben (Schritt 3). Steht die Option richtig, prüfe die
Markierungsdatei: Ohne /var/run/reboot-required löst der Neustart nie aus. Dafür
zuständig ist der Kernel-Hook des Pakets – dpkg -S /etc/kernel/postinst.d/unattended-upgrades muss ihn melden (Schritt 3)./boot läuft voll, Updates schlagen fehl.
Alte Kernel häufen sich an.
Nachlesen: Automatische Sicherheitsupdates mit unattended-upgrades →Remove-Unused-Kernel-Packages "true" setzen (Schritt 3); einmalig aufräumen mit
sudo apt autoremove --purge.Ein Paket wird hartnäckig zurückgehalten (kept back).
unattended-upgrades
installiert keine Updates, die andere Pakete entfernen würden. Solche Fälle löst du
bewusst von Hand mit
Nachlesen: Automatische Sicherheitsupdates mit unattended-upgrades →sudo apt upgrade und prüfst, was passiert.Du hast dich selbst ausgesperrt.
ignoreip fehlte oder enthielt die falsche IP.
Verbinde dich über die Konsole im netcup SCP (unabhängig von SSH) und entsperre
dich mit sudo fail2ban-client set sshd unbanip DEINE_EIGENE_IP. Trage deine IP
anschließend in ignoreip ein und lade neu. Deshalb steht die Whitelist in Schritt 2
an erster Stelle.fail2ban.service startet nicht (systemctl status zeigt „failed").
Fast immer
ein Tippfehler in
Nachlesen: Fail2ban: Brute-Force-Angriffe automatisch blocken →jail.local. Prüfe die Syntax mit sudo fail2ban-client -t
(Testmodus) – der Befehl nennt die fehlerhafte Zeile.Deine Werte aus jail.local greifen nicht.
Es wird nur 10 Minuten gesperrt, oder die
eigene IP fliegt trotz
Nachlesen: Fail2ban: Brute-Force-Angriffe automatisch blocken →ignoreip raus. Fast immer fehlt der Reload – der Dienst lief
schon, bevor du die erste eigene Zeile geschrieben hast, und start/enable --now tut
bei einem laufenden Dienst nichts. Was wirklich gilt, zeigen
sudo fail2ban-client get sshd bantime (600 = Debian-Standard, 3600 = deine Stunde)
und sudo fail2ban-client get sshd ignoreip; übernommen wird es mit
sudo systemctl reload fail2ban.Es wird nie jemand gesperrt, obwohl das Log voller Fehlversuche ist.
Prüfe mit
Nachlesen: Fail2ban: Brute-Force-Angriffe automatisch blocken →sudo fail2ban-client status sshd, ob Total failed überhaupt steigt. Bleibt es bei
0, findet der Filter die Einträge nicht – meist, weil eine veraltete Anleitung einen
logpath auf eine nicht existierende Datei gesetzt hat. Auf Debian 13 den logpath
aus jail.local entfernen und das Journal nutzen (Schritt 2).Sperren „wirken" nicht – die IP verbindet sich weiter.
Auf Debian 13 sperrt Fail2ban
per nftables (
Nachlesen: Fail2ban: Brute-Force-Angriffe automatisch blocken →banaction = nftables aus defaults-debian.conf). Sichtbar wird das
mit sudo nft list table inet f2b-table: Dort steht die Kette f2b-chain und darin ein
Adress-Set addr-set-sshd mit den gesperrten IPs. sudo iptables -L -n | grep f2b
liefert dagegen nichts – das ist kein Fehler, sondern die falsche Werkzeugebene, an
der ältere Anleitungen hängen bleiben. Fehlt die Tabelle ganz, hakt das Zusammenspiel mit
der Firewall – Dienst neu starten und /var/log/fail2ban.log ansehen.subprocess ssh: Host key verification failed beim SFTP-Ziel.
Restic kann den
SSH-Hostkey des Backup-Servers nicht bestätigen, weil er noch nicht bekannt ist.
Verbinde dich einmal manuell (
Nachlesen: Restic-Backups einrichten: verschlüsselt und off-site →ssh BACKUP_BENUTZER@DEIN_BACKUP_HOST) und bestätige
den Fingerprint – oder hinterlege ihn mit ssh-keyscan DEIN_BACKUP_HOST >> ~/.ssh/known_hosts. Danach läuft Restic durch.wrong password oder repository does not exist.
RESTIC_REPOSITORY oder
RESTIC_PASSWORD_FILE ist nicht gesetzt oder zeigt ins Leere – im systemd-Dienst also
die EnvironmentFile prüfen. Ein per Hand gesetztes export gilt nur in der aktuellen
Shell.repository is already locked.
Ein abgebrochener Lauf hat eine Sperre
hinterlassen. Prüfe, dass wirklich kein Backup mehr läuft, dann
Nachlesen: Restic-Backups einrichten: verschlüsselt und off-site →restic unlock.
Niemals blind entsperren, während parallel ein Lauf aktiv ist.Das Backup wird riesig / sichert Unsinn.
Grenze mit
Nachlesen: Restic-Backups einrichten: verschlüsselt und off-site →--exclude/--exclude-file
ein (Caches, Logs, temporäre Dateien) und nutze --one-file-system, damit Restic nicht
in gemountete Fremd-Dateisysteme abtaucht.prune dauert ewig oder wurde abgebrochen.
Kein Grund zur Panik –
Nachlesen: Restic-Backups einrichten: verschlüsselt und off-site →prune ist
wiederaufnehmbar und das Repository bleibt gültig. Starte es erneut und lass
anschließend einmal restic check laufen. Trenne --prune bei großen Repos vom
täglichen Backup (siehe Schritt 6).Der Timer läuft, aber in Uptime Kuma kommt nie eine Erfolgsmeldung.
Sieh dir den
letzten Lauf mit
Nachlesen: Restic-Backups einrichten: verschlüsselt und off-site →journalctl -u restic-backup.service an. Meist bricht das Skript
vor dem curl-Aufruf ab (z. B. der DB-Dump schlug fehl) – dank set -euo pipefail
stoppt es dann sauber, statt ein kaputtes Backup als Erfolg zu melden. Der ausbleibende
Push ist also kein Bug, sondern genau das Alarmsignal, das du haben willst.Im Browser „Zertifikat ungültig" oder Traefik-Log zeigt ACME-Fehler.
Die drei
üblichen Gründe: (1) Der DNS-Record zeigt noch nicht auf den Server –
Nachlesen: Traefik: Reverse Proxy mit automatischem HTTPS →dig +short DEINE_DOMAIN prüfen. (2) Port 80 ist von außen nicht erreichbar
(Firewall/netcup-Firewall) – die HTTP-Challenge braucht ihn. (3) Du hast das
Rate-Limit der Produktiv-CA gerissen – auf den Staging-Server wechseln (Tipp in
Schritt 3), testen, dann zurück.404 page not found beim Aufruf der App-Domain.
Traefik kennt die Route nicht.
Prüfe: Hat der Container
Nachlesen: Traefik: Reverse Proxy mit automatischem HTTPS →traefik.enable=true? Hängt er im proxy-Netzwerk?
Stimmt die Domain in der Host(...)-Regel exakt (inkl. Subdomain)? Das Dashboard
(Schritt 7) zeigt unter „HTTP Routers", ob der Router registriert wurde.Der Browser zeigt Traefiks selbstsigniertes Notfall-Zertifikat; im Log steht
permissions 644 for /acme.json are too open, please use 600.
Traefik läuft, hat
aber den ACME-Resolver übersprungen – daher kein echtes Zertifikat.
Nachlesen: Traefik: Reverse Proxy mit automatischem HTTPS →chmod 600 acme.json nachholen (Schritt 2) und Container neu starten.Keine App wird geroutet; im Traefik-Log wiederholt sich client version 1.24 is too old. Minimum supported API version is 1.40.
Deine Traefik-Version ist zu alt für
deine Docker-Engine – der Docker-Provider kann den Socket nicht mehr abfragen.
Aktuelles Docker (Engine 29, API-Level ≥ 1.40) braucht Traefik ≥ v3.6; deshalb
nutzt dieses Tutorial
Nachlesen: Traefik: Reverse Proxy mit automatischem HTTPS →traefik:v3.7. Gegen Docker 29 nachgestellt: v3.5.6 läuft in
genau diesen Fehler, v3.6.25 spricht wieder sauber mit dem Socket. Ältere Tags wie
v3.3 oder v3.5 funktionieren mit neuem Docker also nicht mehr – Image-Tag
hochziehen und docker compose up -d erneut ausführen.Basic-Auth am Dashboard wird sofort wieder abgewiesen / Router fehlt.
In der
Nachlesen: Traefik: Reverse Proxy mit automatischem HTTPS →compose.yaml müssen die $-Zeichen des Hashes verdoppelt sein ($$). Prüfe
den Hash außerhalb noch einmal mit htpasswd -nbB.Gateway Timeout oder Traefik erreicht den Container nicht.
Meist hängt die App
im falschen Netzwerk oder Traefik weiß nicht, welches gemeint ist.
Nachlesen: Traefik: Reverse Proxy mit automatischem HTTPS →providers.docker.network=proxy in Traefik und networks: [proxy] an der App
müssen zusammenpassen.502 Bad Gateway, obwohl der Container läuft.
Traefik erreicht den Container,
trifft aber den falschen Port. Lauscht die App nicht auf 80, braucht sie das Label
Nachlesen: Traefik: Reverse Proxy mit automatischem HTTPS →traefik.http.services.<name>.loadbalancer.server.port=<echter-port>. Genau dieser
Fall begegnet dir bei der ersten App im nächsten Tutorial (Uptime Kuma auf 3001).did not find expected key (oder ähnliche YAML-Fehler).
YAML ist
einrückungssensibel – ausschließlich Leerzeichen, niemals Tabs, und pro Ebene
konsistent (üblich: 2 Leerzeichen). Prüfe die Datei ohne sie zu starten:
Nachlesen: Docker Compose verstehen: Services, Volumes, Netzwerke →docker compose config meldet den Fehler mit Zeile und Spalte (go-yaml load error in parser … at L2.C3-L4.C4 – die falsche Zeile ist die hintere Angabe).address already in use oder port is already allocated beim up.
Der Host-Port
(links in
Nachlesen: Docker Compose verstehen: Services, Volumes, Netzwerke →8080:80) ist schon belegt – im ersten Fall von einem Programm auf dem Server,
im zweiten von einem anderen Container (welchem, zeigt docker ps). Finde den Beleger mit
sudo ss -tlnp | grep 8080 oder wähle einen anderen Host-Port.Eine App findet ihre Datenbank nicht (could not translate host name).
Als
Hostname muss der Service-Name stehen (z. B.
Nachlesen: Docker Compose verstehen: Services, Volumes, Netzwerke →db), nicht localhost. Innerhalb
eines Containers ist localhost der Container selbst, nicht der Nachbar-Service. Und:
Beide Services müssen im selben Compose-Projekt (derselben Datei) liegen.Docker Compose: Nach docker compose down sind alle Daten weg.
Entweder lag das Volume nicht als
Named Volume unter
Nachlesen: Docker Compose verstehen: Services, Volumes, Netzwerke →volumes: vor (dann war es nur der vergängliche
Container-Speicher), oder es wurde down -v verwendet. Persistente Dienste immer mit
deklariertem Named Volume fahren.docker-compose: command not found.
Das ist das alte Compose v1 (mit Bindestrich).
Aktuell ist
Nachlesen: Docker Compose verstehen: Services, Volumes, Netzwerke →docker compose (mit Leerzeichen, Plugin). Falls es fehlt: sudo apt install docker-compose-plugin (siehe
Docker-Tutorial).dig liefert keine oder eine falsche (alte) IP.
Meist noch Propagation. Frage
gezielt einen öffentlichen Resolver, der deinen lokalen Cache umgeht:
Nachlesen: Eine Domain mit dem Server verbinden (DNS-Grundlagen) →dig +short DEINE_DOMAIN @1.1.1.1. Zeigt der schon den richtigen Wert, ist nur dein
lokaler/Provider-Cache noch nicht abgelaufen – abwarten.Die Domain zeigt zwar, aber die falsche IP – z. B. eine Parking-Seite des Registrars.
Oft existiert noch ein alter A-Record oder eine
Weiterleitung/Parking-Einstellung. Entferne widersprüchliche Einträge; pro Name und
Typ sollte genau ein Wert stehen (bewusste Ausnahmen ausgenommen).
Nachlesen: Eine Domain mit dem Server verbinden (DNS-Grundlagen) →IPv4 klappt, IPv6 (AAAA) führt zu Timeouts.
Du hast einen AAAA-Record
eingetragen, obwohl der Server keine funktionierende IPv6-Adresse hat. Browser
bevorzugen dann IPv6 und laufen in einen Timeout. AAAA-Record entfernen, bis der
Server wirklich IPv6 kann.
Nachlesen: Eine Domain mit dem Server verbinden (DNS-Grundlagen) →In manchen Oberflächen wird der Wert mit angehängtem Punkt gespeichert
(DEINE_DOMAIN.) und du bist unsicher.
Der abschließende Punkt (Root der
DNS-Hierarchie) ist normal und korrekt – viele DNS-Verwaltungen ergänzen ihn
automatisch. Kein Grund zur Sorge.
Nachlesen: Eine Domain mit dem Server verbinden (DNS-Grundlagen) →Vom Server verschickte E-Mails landen im Spam oder werden abgelehnt (im Mail-Log
steht z. B. does not resolve to address oder no PTR record).
Der
Reverse-DNS-Eintrag (PTR) fehlt oder passt nicht zum Absender-Hostnamen. Setze den
PTR wie in Schritt 5 beschrieben beim VPS-Anbieter und achte darauf, dass er auf
denselben Namen zeigt, der auch per A-/AAAA-Record auflöst.
Nachlesen: Eine Domain mit dem Server verbinden (DNS-Grundlagen) →Nach ufw enable kommst du per SSH nicht mehr rein.
Die SSH-Regel fehlte oder
betraf den falschen Port. Verbinde dich über die Konsole im netcup SCP (VNC,
unabhängig von SSH), erlaube dort deinen SSH-Port (
Nachlesen: Firewall mit UFW einrichten →sudo ufw allow …) und teste
erneut. Genau davor warnt Schritt 3.ERROR: Could not find a profile matching 'OpenSSH'.
Das OpenSSH-Profil
existiert nur, wenn
Nachlesen: Firewall mit UFW einrichten →openssh-server installiert ist. Nutze stattdessen die
Portnummer: sudo ufw allow 22/tcp (bzw. deinen Port). sudo ufw app list zeigt die
verfügbaren Profile.Ein Docker-Container ist von außen erreichbar, obwohl UFW den Port nicht freigibt.
Kein Fehler von dir – Docker umgeht UFW. Docker schreibt seine Regeln
direkt in
Nachlesen: Firewall mit UFW einrichten →iptables und hängt sie vor die UFW-Ketten. Ein veröffentlichter
Container-Port (ports: in der compose.yaml) ist damit offen, egal was UFW sagt. Die
saubere Lösung ist eine zweite Firewall-Ebene vor dem Server – bei netcup die
Firewall im SCP als vorgelagerter
Perimeter. Auf dem Host hilft außerdem, Container-Ports nur an 127.0.0.1 zu binden
statt an 0.0.0.0.„Erstellen" legt keinen Snapshot an, solange eine DVD eingelegt ist.
Hängt unter
„Medien → DVD-Laufwerk" ein .iso-Image im virtuellen Laufwerk, verweigert das SCP neue
Snapshots. Wirf das Image dort aus (in der Server-Übersicht muss die Zeile ISO wieder
Nachlesen: netcup SCP: Snapshots, Konsole & Rettung →- zeigen) und starte den Snapshot erneut.Der Snapshot lässt sich nicht anlegen, weil der Speicherplatz nicht reicht.
Ein
Snapshot braucht Platz neben deinen Live-Daten. Räume auf dem Server auf, gib die
freigewordenen Blöcke mit
Nachlesen: netcup SCP: Snapshots, Konsole & Rettung →fstrim -av an den Host zurück und lösche nicht mehr benötigte
Snapshots. Bringt das nichts, stößt du im SCP unter „Medien → Festplatten" die
Speicheroptimierung an. Plane dafür Downtime ein: netcup fährt den Server dazu
herunter, optimiert die Platte und startet ihn wieder.Nach einem Online-Snapshot-Restore ist die Datenbank beschädigt.
Ein
Online-Snapshot fängt einen laufenden Schreibvorgang womöglich mittendrin ein. Für
Server mit Datenbank nimm einen Offline-Snapshot oder erstelle vorher einen
Datenbank-Dump.
Nachlesen: netcup SCP: Snapshots, Konsole & Rettung →Du kommst nicht ins SCP.
Das SCP nutzt eigene Zugangsdaten (nicht SSH). Sie
stehen in der Willkommensmail; ein vergessenes SCP-Passwort setzt du im
netcup-Kundenkonto (CCP) zurück.
Nachlesen: netcup SCP: Snapshots, Konsole & Rettung →Nach dem Aktivieren geht keine Namensauflösung mehr (apt update hängt, ping domain.de
scheitert, aber ping 1.1.1.1 geht).
Die DNS-Antworten werden geblockt. Prüfe im
Basis-Template die Regel EINGEHEND UDP ACCEPT, Src-Port 53 (Quell-Port, nicht Ziel-Port).
Nachlesen: netcup-Firewall im SCP einrichten →Die Uhr driftet, oder TLS-Zertifikate werden wegen falscher Zeit abgelehnt.
Die
NTP-Antworten fehlen. Ergänze EINGEHEND UDP ACCEPT, Src-Port 123.
Nachlesen: netcup-Firewall im SCP einrichten →IPv6 funktioniert nicht mehr (v4 schon).
Es fehlt die ICMPv6-Regel. Ohne Neighbor
Discovery kann der Server über IPv6 nicht einmal seinen Nachbarn (Router) finden.
Nachlesen: netcup-Firewall im SCP einrichten →Du kommst nach dem Aktivieren nicht mehr per SSH rein.
Die SSH-Regel fehlt oder nennt
den falschen Port. Über die VNC-Konsole (SCP → Bildschirm) kommst du trotzdem auf den
Server; korrigiere die Policy und speichere neu.
Nachlesen: netcup-Firewall im SCP einrichten →Der Server kann keine E-Mails versenden (Port 25 raus geht nicht).
Kein Fehler deiner
Policy, sondern netcups Default-Policy „netcup Mail block". Wie du sie abnimmst, steht unter
Port 25 freischalten.
Nachlesen: netcup-Firewall im SCP einrichten →Der Server läuft zunächst normal und ist nach ein bis zwei Wochen plötzlich offline.
Nutzt der Server DHCP, wird die Lease-Erneuerung von der Whitelist geblockt. Ergänze
Nachlesen: netcup-Firewall im SCP einrichten →EINGEHEND · UDP · ACCEPT · Src 67 im Basis-Template (siehe DHCP-Tipp in Schritt 2).E: Package 'docker-ce' has no installation candidate.
Die Paketquelle aus
Schritt 2 fehlt oder ist fehlerhaft – apt kennt den Namen nur aus den Abhängigkeiten
der Debian-Pakete, findet aber kein Paket dazu. Prüfe den Inhalt von
Nachlesen: Docker auf Debian installieren →/etc/apt/sources.list.d/docker.list – dort muss deine Debian-Version (z. B.
trixie) stehen – und führe danach erneut sudo apt update aus.permission denied while trying to connect to the docker API at unix:///var/run/docker.sock.
Die
Nachlesen: Docker auf Debian installieren →docker-Gruppenmitgliedschaft greift noch nicht. SSH-Sitzung beenden und neu
verbinden; groups muss danach docker enthalten. Falls nicht, Schritt 4
wiederholen.Konflikte bei der Installation mit bereits vorhandenen Paketen.
Auf dem System
ist schon eine andere Docker-Variante installiert (
Nachlesen: Docker auf Debian installieren →docker.io, podman-docker, …).
Alte Pakete zuerst entfernen: sudo apt remove docker.io docker-doc docker-compose podman-docker containerd runc – bestehende Container/Images bleiben dabei erhalten.docker compose meldet docker: unknown command: docker compose.
Das
Compose-Plugin fehlt – wahrscheinlich wurde Docker früher anders installiert.
Nachlesen: Docker auf Debian installieren →sudo apt install docker-compose-plugin nachholen. Achtung: Das alte
docker-compose (mit Bindestrich) ist ein anderes, veraltetes Werkzeug.SSH fragt trotz ssh-copy-id weiter nach dem Passwort.
Meist stimmen die
Dateirechte auf dem Server nicht: SSH ignoriert
Nachlesen: SSH-Zugang absichern →authorized_keys, wenn Gruppe
oder andere in ~/.ssh schreiben dürfen. Im Log auf dem Server (sudo journalctl -u ssh --since -5min) steht dann Authentication refused: bad ownership or modes for directory /home/koch/.ssh. Repariere mit chmod 700 ~/.ssh && chmod 600 ~/.ssh/authorized_keys und prüfe außerdem, dass du dich mit dem richtigen
Benutzer verbindest (koch@…, nicht root@…).Mit Permission denied (publickey) kommst du gar nicht mehr rein.
Passwort-Login wurde deaktiviert, bevor der Schlüssel funktionierte. Öffne die
VNC-Konsole im netcup SCP, melde dich dort lokal an, setze in
Nachlesen: SSH-Zugang absichern →/etc/ssh/sshd_config.d/00-ssh-absichern.conf vorübergehend
PasswordAuthentication yes, starte SSH neu und beginne wieder bei Schritt 2.Nach dem Neustart startet der SSH-Dienst nicht mehr.
Die Konfiguration hat einen
Syntaxfehler, schon ein verschriebenes
Nachlesen: SSH-Zugang absichern →PasswordAuthentification genügt (deshalb
sshd -t aus Schritt 4). Über die VNC-Konsole einloggen, dann nennt
sudo sshd -t Datei, Zeile und Option:
/etc/ssh/sshd_config.d/00-ssh-absichern.conf: line 2: Bad configuration option: PasswordAuthentification gefolgt von … terminating, 1 bad configuration options.Einstellungen scheinen zu greifen, Passwort-Login geht aber weiterhin.
Deine Datei
ist nicht die erste, die den Wert setzt (siehe „Der erste Wert gewinnt“). Zeigt
Nachlesen: SSH-Zugang absichern →sshd -T aus Schritt 4 yes, prüfe mit ls /etc/ssh/sshd_config.d/, ob eine andere
Datei alphabetisch vor deiner liegt und ob deine wirklich auf .conf endet. Nur solche
Dateien bindet die Include-Zeile ein. Danach SSH neu starten.ssh: connect to host … port 22: Connection timed out.
Meist ist die IP falsch
abgetippt oder der Server noch nicht fertig provisioniert. Prüfe die IP in deinem
Kundenkonto und ob der Server dort als „online" angezeigt wird. Warte nach der
Bestellung ein paar Minuten.
Nachlesen: Erste Schritte mit einem netcup VPS →Permission denied, please try again beim root-Login.
Falsches Passwort, oft
ein Copy-Paste-Problem mit unsichtbaren Leerzeichen am Ende oder ein abweichendes
Tastaturlayout. Kopiere das Passwort ohne umgebende Leerzeichen direkt aus den
Zugangsdaten.
Nachlesen: Erste Schritte mit einem netcup VPS →WARNING: REMOTE HOST IDENTIFICATION HAS CHANGED!.
Der Server wurde neu
installiert und hat einen neuen Host-Key, und SSH schlägt zu Recht Alarm. Wenn du
selbst neu installiert hast, entferne den alten Eintrag mit
Nachlesen: Erste Schritte mit einem netcup VPS →ssh-keygen -R DEINE_SERVER_IP und verbinde neu. Hast du nicht neu installiert, geh der Sache nach,
bevor du dich verbindest.sudo: command not found als neuer Benutzer.
Auf Minimal-Images fehlt das Paket
manchmal. Als
Nachlesen: Erste Schritte mit einem netcup VPS →root nachinstallieren: apt install sudo. Danach prüfen, dass der
Benutzer in der Gruppe ist: groups koch muss sudo enthalten, sonst Schritt 3
wiederholen und einmal ab- und wieder anmelden.Nichts gefunden. Versuch es mit weniger Wörtern oder der wörtlichen Fehlermeldung.