Zum Inhalt springen
Serverküche
Suche

Die Suche wird geladen …

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: 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.
Nachlesen: Outline: das moderne Team-Wiki mit Authentik-Login →

Nach der Anmeldung kommt redirect_uri als Fehler zurück.

Die bei Authentik hinterlegte Adresse muss exakt 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.
Nachlesen: Outline: das moderne Team-Wiki mit Authentik-Login →

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 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.
Nachlesen: Outline: das moderne Team-Wiki mit Authentik-Login →

Outline startet, aber niemand kann sich anmelden, und in den Protokollen fehlt die Zeile OIDC plugin registered.

Dann ist mindestens eine der sechs 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.
Nachlesen: Outline: das moderne Team-Wiki mit Authentik-Login →

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 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.
Nachlesen: Jitsi Meet: eigene Videokonferenzen ohne Zoom →

Der Web-Container startet, meldet aber cp: cannot stat '/config/.': Permission denied und liefert nichts aus.

Die gemounteten Ordner unter /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.
Nachlesen: Jitsi Meet: eigene Videokonferenzen ohne Zoom →

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 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.
Nachlesen: Jitsi Meet: eigene Videokonferenzen ohne Zoom →

Alle sind im Raum, aber niemand hört oder sieht jemanden.

Das ist fast immer der Medienpfad, nicht die Konferenz. Prüf zuerst 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.
Nachlesen: Jitsi Meet: eigene Videokonferenzen ohne Zoom →

Nach docker compose down ist das Moderatorkonto verschwunden.

Prosody legt Konten unter /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.
Nachlesen: Jitsi Meet: eigene Videokonferenzen ohne Zoom →

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 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.
Nachlesen: Jitsi Meet: eigene Videokonferenzen ohne Zoom →

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 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.
Nachlesen: Matrix Teil 2: Element Web, Föderation und Admin-Alltag →

Der Element-Container startet nicht und meldet cp: can't open '/app/config.json': Permission denied.

Die 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.
Nachlesen: Matrix Teil 2: Element Web, Föderation und Admin-Alltag →

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 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.
Nachlesen: Matrix Teil 2: Element Web, Föderation und Admin-Alltag →

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 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.
Nachlesen: Matrix Teil 2: Element Web, Föderation und Admin-Alltag →

Synapse startet nicht und meldet IncorrectDatabaseSetup: Database has incorrect collation.

Die Datenbank wurde mit einer sprachabhängigen Sortierung angelegt, etwa 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.
Nachlesen: Matrix: der eigene Chat-Server mit Synapse (Teil 1) →

Der Föderationstester meldet FederationOK: false, obwohl die Seite im Browser lädt.

Dann stimmt meist die Delegation nicht. Prüf 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.
Nachlesen: Matrix: der eigene Chat-Server mit Synapse (Teil 1) →

In den Logs steht bei jedem Zugriff die IP von Traefik statt der des Besuchers.

Es fehlt 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.
Nachlesen: Matrix: der eigene Chat-Server mit Synapse (Teil 1) →

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 @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.
Nachlesen: Matrix: der eigene Chat-Server mit Synapse (Teil 1) →

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.
Nachlesen: Wann reicht der kleine Server nicht mehr? →

Der Load-Average ist hoch, aber r und b stehen beide auf 0.

Du liest die erste 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.
Nachlesen: Wann reicht der kleine Server nicht mehr? →

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 available; free darf getrost nahe null stehen.
Nachlesen: Wann reicht der kleine Server nicht mehr? →

Viel Reclaimable, aber docker image prune -a gibt kaum etwas frei.

Dann hängen die Images noch an gestoppten Containern. Erst 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.
Nachlesen: Wann reicht der kleine Server nicht mehr? →

Der Container startet immer neu und meldet error loading flags: flag needs an argument: --config.

Beim Kopieren der 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.
Nachlesen: listmonk: eigener Newsletter-Server, DSGVO-freundlich →

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 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.
Nachlesen: listmonk: eigener Newsletter-Server, DSGVO-freundlich →

Der Datenbank-Container startet nicht und redet von pg_ctlcluster.

Das ist die PostgreSQL-18-Umstellung: Der Mount darf nicht mehr auf /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.
Nachlesen: listmonk: eigener Newsletter-Server, DSGVO-freundlich →

Die Kampagne bleibt auf running stehen und es wird nichts versendet.

Dann erreicht listmonk den SMTP-Server nicht. 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.
Nachlesen: listmonk: eigener Newsletter-Server, DSGVO-freundlich →

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 /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.
Nachlesen: HedgeDoc: gemeinsame Markdown-Notizen in Echtzeit →

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 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.
Nachlesen: HedgeDoc: gemeinsame Markdown-Notizen in Echtzeit →

Ein Gast hat deine Notiz bearbeitet, obwohl CMD_ALLOW_ANONYMOUS_EDITS auf false steht.

Diese Option wirkt ausschließlich dann, wenn 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.
Nachlesen: HedgeDoc: gemeinsame Markdown-Notizen in Echtzeit →

In der Notizliste tauchen Notizen wie wp-json oder xmlrpc.php auf, die niemand angelegt hat.

Das waren Bots, die nach WordPress suchen. Bei 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.
Nachlesen: HedgeDoc: gemeinsame Markdown-Notizen in Echtzeit →

Ein Außenstehender bekommt beim veröffentlichten Link nur eine Weiterleitung auf die Startseite.

Dann steht die Notiz auf 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.
Nachlesen: HedgeDoc: gemeinsame Markdown-Notizen in Echtzeit →

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 sourcerange und starte mit docker compose up -d neu.
Nachlesen: Pingvin Share X: große Dateien teilen ohne WeTransfer →

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 https://DEINE_DOMAIN ein und speichere; bereits verschickte Links musst du neu erzeugen.
Nachlesen: Pingvin Share X: große Dateien teilen ohne WeTransfer →

In den Zugriffsprotokollen steht bei jedem Besucher dieselbe IP.

Das ist die Adresse aus dem Docker-Proxy-Netz, und es fehlt 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.
Nachlesen: Pingvin Share X: große Dateien teilen ohne WeTransfer →

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: curl -s -o /dev/null -w "%{http_code}\n" https://DEINE_DOMAIN/auth/signUp muss danach 307 liefern und nicht 200.
Nachlesen: Pingvin Share X: große Dateien teilen ohne WeTransfer →

Nach dem Anmelden wirst du sofort wieder ausgeloggt.

Meist ist Secure cookies eingeschaltet, während der Aufruf über 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."
Nachlesen: Pingvin Share X: große Dateien teilen ohne WeTransfer →

eosctl compute vm delete meldet nichts, die VM läuft weiter.

eos löscht nur ausgeschaltete VMs und sagt das nicht. Erst eosctl compute vm power-off, warten bis power_state auf stopped steht, dann löschen (Schritt 6).
Nachlesen: netcup eos automatisieren: eosctl und OpenTofu →

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).
Nachlesen: netcup eos automatisieren: eosctl und OpenTofu →

Von mehreren Befehlen kommt nur die erste Ausgabe zurück.

Die inneren Anführungszeichen in bash -c sind einfache. Nimm maskierte doppelte, wie in Schritt 5.
Nachlesen: netcup eos automatisieren: eosctl und OpenTofu →

OpenTofu bricht beim Anlegen mit einem Berechtigungsfehler ab.

Lesen darf jeder Zugang, schreiben nur mit Rolle. Für dieses Setup braucht er 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.
Nachlesen: netcup eos automatisieren: eosctl und OpenTofu →

tofu init findet den Provider nicht.

Die source muss den Hostnamen enthalten: dl.eoscloud.io/eos/eoscloud. Ohne ihn sucht OpenTofu in seiner eigenen Registry, wo der Provider nicht liegt.
Nachlesen: netcup eos automatisieren: eosctl und OpenTofu →

Der Login mit dem richtigen Passwort schlägt fehl, obwohl der Hash stimmt.

Dann steht der Hash vermutlich in einer .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.
Nachlesen: code-server: VS Code im Browser auf dem eigenen Server →

Traefik antwortet mit 401, obwohl du das richtige BasicAuth-Passwort eingibst.

Gleiche Ursache an anderer Stelle: Im 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.
Nachlesen: code-server: VS Code im Browser auf dem eigenen Server →

Im Terminal kommt bash: python3: command not found.

Das offizielle Image enthält nur den Editor, keine Sprachlaufzeiten – 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.
Nachlesen: code-server: VS Code im Browser auf dem eigenen Server →

code-server kann eine Datei nicht speichern und meldet Permission denied.

Die Ordner unter 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.
Nachlesen: code-server: VS Code im Browser auf dem eigenen Server →

sudo im Terminal bricht mit The "no new privileges" flag is set ab.

Das ist kein Defekt, sondern die Wirkung von 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.
Nachlesen: code-server: VS Code im Browser auf dem eigenen Server →

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 curl von einem fremden Rechner, nicht von localhost.
Nachlesen: 100 Tage netcup: was dir vorher niemand sagt →

Die Platte ist voll, aber du findest keine großen Dateien.

Sieh bei Docker nach: 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.
Nachlesen: 100 Tage netcup: was dir vorher niemand sagt →

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 constraint=CONSTRAINT_MEMCG. Genau einmal ist uns das passiert – erhöhe das Limit des Dienstes, bevor du über einen größeren Server nachdenkst.
Nachlesen: 100 Tage netcup: was dir vorher niemand sagt →

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: 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.
Nachlesen: Dienste nur im VPN erreichbar machen →

Auch aus dem VPN kommt 403.

Dann sieht Traefik eine andere Quell-IP als die des VPN-Clients. Prüf das mit 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.
Nachlesen: Dienste nur im VPN erreichbar machen →

Der Name löst im VPN weiter auf die öffentliche IP auf.

Der Client benutzt AdGuard nicht. Kontrollier zuerst 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.
Nachlesen: Dienste nur im VPN erreichbar machen →

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 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.
Nachlesen: Dienste nur im VPN erreichbar machen →

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 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.
Nachlesen: Dienste nur im VPN erreichbar machen →

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 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.
Nachlesen: Dienste nur im VPN erreichbar machen →

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 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“).
Nachlesen: netcup eos ausprobiert: die neue Cloud in der Preview →

Der Schlüssel wird abgelehnt, im Log steht account is locked.

Deine Cloud-Init-Datei enthält 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.
Nachlesen: netcup eos ausprobiert: die neue Cloud in der Preview →

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 @vm-name eingetragen. Trage stattdessen die interne IP der VM ein, die auf der Detailseite steht.
Nachlesen: netcup eos ausprobiert: die neue Cloud in der Preview →

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 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.
Nachlesen: Headscale: das eigene Tailscale-Netz →

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.
Nachlesen: Headscale: das eigene Tailscale-Netz →

apt-get update meldet The repository 'https://pkgs.tailscale.com/...' is not signed.

Schau in die Zeile darüber, dort steht meist 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.
Nachlesen: Headscale: das eigene Tailscale-Netz →

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.
Nachlesen: Headscale: das eigene Tailscale-Netz →

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 curl https://DEINE_DOMAIN/health nicht {"status":"pass"} liefert – dann liegt es an Traefik, nicht an Headscale.
Nachlesen: Headscale: das eigene Tailscale-Netz →

Ein Client verbindet sich nicht und bleibt bei der Anmeldung hängen.

Prüf zuerst die Clientversion mit 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.
Nachlesen: Headscale: das eigene Tailscale-Netz →

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 -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.
Nachlesen: Headscale: das eigene Tailscale-Netz →

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 > 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.
Nachlesen: Wie sicher ist mein Server? Selbst-Audit mit Lynis →

Nach dem Anwenden der sysctl-Werte haben alle Container kein Netz mehr.

Dann ist 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.
Nachlesen: Wie sicher ist mein Server? Selbst-Audit mit Lynis →

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 /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.
Nachlesen: Wie sicher ist mein Server? Selbst-Audit mit Lynis →

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 grep "^suggestion\[\]=SSH-7408" /var/log/lynis-report.dat – dort findest du für jede Zeile den Parameter und den Zielwert.
Nachlesen: Wie sicher ist mein Server? Selbst-Audit mit Lynis →

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.
Nachlesen: Wie sicher ist mein Server? Selbst-Audit mit Lynis →

Der Container startet nicht und meldet Operation not permitted.

Du hast eine Capability zu viel entzogen. Die Meldung nennt fast immer den Systemaufruf – 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.
Nachlesen: Docker-Container absichern mit Least Privilege →

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".
Nachlesen: Docker-Container absichern mit Least Privilege →

Read-only file system beim Start.

Die Anwendung braucht ein Schreibverzeichnis, das du noch nicht als 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.
Nachlesen: Docker-Container absichern mit Least Privilege →

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 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.
Nachlesen: Docker-Container absichern mit Least Privilege →

Permission denied im tmpfs, obwohl read_only passt.

Ein 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.
Nachlesen: Docker-Container absichern mit Least Privilege →

Der Container wird ohne Vorwarnung beendet, docker inspect zeigt ExitCode 137.

Das ist der OOM-Killer: 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.
Nachlesen: Docker-Container absichern mit Least Privilege →

Es kommt gar keine Code-Abfrage, die Anmeldung läuft wie vorher durch.

Dann ist 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.
Nachlesen: SSH mit Zwei-Faktor-Authentifizierung (TOTP) absichern →

Nach dem Schlüssel wird zusätzlich das Passwort verlangt.

Kein Fehler, sondern die Folge von 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.
Nachlesen: SSH mit Zwei-Faktor-Authentifizierung (TOTP) absichern →

Der Code wird abgelehnt, obwohl die App ihn gerade anzeigt.

Meist läuft die Serveruhr auseinander. TOTP toleriert nur wenige Sekunden. Prüfe 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.
Nachlesen: SSH mit Zwei-Faktor-Authentifizierung (TOTP) absichern →

Nach drei Fehlversuchen geht gar nichts mehr.

Das ist die Ratenbegrenzung aus -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.
Nachlesen: SSH mit Zwei-Faktor-Authentifizierung (TOTP) absichern →

Ein Benutzer kommt ohne Code rein.

Entweder fehlt seine ~/.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.
Nachlesen: SSH mit Zwei-Faktor-Authentifizierung (TOTP) absichern →

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 (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.
Nachlesen: SSH mit Zwei-Faktor-Authentifizierung (TOTP) absichern →

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.
Nachlesen: Stalwart oder Mailcow? Zwei Mailserver im Vergleich →

Das Mailprogramm warnt vor einem selbstsignierten Zertifikat CN=rcgen self signed cert.

Stalwart liefert noch seinen Platzhalter aus. Erst mit 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.
Nachlesen: Stalwart oder Mailcow? Zwei Mailserver im Vergleich →

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 mailcow.conf mit SKIP_CLAMD=y ab, denn der Virenscanner ist der größte Speicherfresser.
Nachlesen: Stalwart oder Mailcow? Zwei Mailserver im Vergleich →

Das Skript bricht beim Ermitteln der Flows mit IndexError: list index out of range ab.

Das passiert nur direkt nach einer frischen Installation: /-/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.
Nachlesen: Authentik Teil 2: Apps anbinden – Forward-Auth & OIDC →

Der Aufruf leitet auf http://localhost/application/o/authorize/… weiter.

Der eingebettete Outpost kennt seine öffentliche Adresse nicht: Das Feld authentik_host ist leer. Setz es auf https://DEINE_DOMAIN/ (Schritt 3) – vorher landet jeder Nutzer auf einer toten Seite.
Nachlesen: Authentik Teil 2: Apps anbinden – Forward-Auth & OIDC →

Traefik antwortet mit 500 oder es kommt gar keine Weiterleitung.

Dann erreicht die Middleware den Outpost nicht. Die 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.
Nachlesen: Authentik Teil 2: Apps anbinden – Forward-Auth & OIDC →

Der Dienst ist geschützt, kennt aber den Benutzer nicht.

Es fehlt authResponseHeaders an der Middleware. Ohne diese Liste verwirft Traefik die Identitäts-Header aus Authentiks Antwort – die Anmeldung funktioniert, die Anwendung sieht aber nichts.
Nachlesen: Authentik Teil 2: Apps anbinden – Forward-Auth & OIDC →

Nach der Anmeldung landet man in einer Weiterleitungsschleife.

Meist passt 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.
Nachlesen: Authentik Teil 2: Apps anbinden – Forward-Auth & OIDC →

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 https://GRAFANA_DOMAIN/login/generic_oauth. Ein fehlender Schrägstrich reicht zum Scheitern.
Nachlesen: Authentik Teil 2: Apps anbinden – Forward-Auth & OIDC →

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 sourcerange und starte mit docker compose up -d neu.
Nachlesen: Authentik: Single Sign-On für alle Dienste (Teil 1) →

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 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.
Nachlesen: Authentik: Single Sign-On für alle Dienste (Teil 1) →

Die Seite antwortet minutenlang mit 404, obwohl die Container laufen.

Beim ersten Start laufen über 550 Datenbank-Migrationen; solange gibt auch /-/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.
Nachlesen: Authentik: Single Sign-On für alle Dienste (Teil 1) →

Beim Aufruf des Setup-Flows kommt „Anfrage wurde verweigert".

Der Einrichtungs-Flow lässt sich nicht direkt über /if/flow/initial-setup/ aufrufen. Geh auf die Wurzel-Adresse https://DEINE_DOMAIN/, von dort leitet Authentik korrekt weiter.
Nachlesen: Authentik: Single Sign-On für alle Dienste (Teil 1) →

Die Kachel „Arbeiter" zeigt 0.

Der 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.
Nachlesen: Authentik: Single Sign-On für alle Dienste (Teil 1) →

Traefik antwortet mit 404.

Es fehlt meist traefik.http.services.authentik.loadbalancer.server.port=9000. Der Container lauscht auf 9000; Port 9443 ist Authentiks eigenes HTTPS, das wir bewusst nicht nutzen.
Nachlesen: Authentik: Single Sign-On für alle Dienste (Teil 1) →

Nach einem Neuaufsetzen sind alle Sitzungen ungültig oder die Anmeldung schlägt fehl.

Dann hat sich der 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.
Nachlesen: Authentik: Single Sign-On für alle Dienste (Teil 1) →

Der Benutzername passt nicht.

Das beim Setup erzeugte Konto heißt akadmin, nicht wie deine E-Mail-Adresse. Wer sich mit der Adresse anmelden will, muss das im Identifikations-Stage des Anmelde-Flows erlauben.
Nachlesen: Authentik: Single Sign-On für alle Dienste (Teil 1) →

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 name@file. Ohne Zusatz sucht Traefik sie unter den Docker-Labels – und findet nichts. Umgekehrt gilt dasselbe für name@docker.
Nachlesen: Traefik härten: Security-Header, Rate-Limit & Co. →

BasicAuth lehnt das richtige Passwort ab.

Die $-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.
Nachlesen: Traefik härten: Security-Header, Rate-Limit & Co. →

Das Rate-Limit scheint nicht zu greifen.

Sequenzielle 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.
Nachlesen: Traefik härten: Security-Header, Rate-Limit & Co. →

Nach dem Setzen der IP-Allowlist bekommst du selbst 403.

Häufigster Grund: Du hast nur deine IPv4 eingetragen, kommst aber per IPv6. Vergleiche 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.
Nachlesen: Traefik härten: Security-Header, Rate-Limit & Co. →

Der Browser kommt trotz korrigierter Konfiguration nicht mehr per HTTP durch.

Das ist HSTS und kein Fehler: Der Browser hat sich 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.
Nachlesen: Traefik härten: Security-Header, Rate-Limit & Co. →

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 sourcerange und starte mit docker compose up -d neu.
Nachlesen: Dockge: Compose-Stacks im Browser verwalten →

Traefik antwortet mit 404, obwohl der Container healthy ist.

Meist fehlt 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.
Nachlesen: Dockge: Compose-Stacks im Browser verwalten →

Der Deploy bricht mit „no such file or directory" ab.

Host- und Container-Pfad des Stacks-Verzeichnisses stimmen nicht überein. Es muss /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.
Nachlesen: Dockge: Compose-Stacks im Browser verwalten →

Ein Stack ist sichtbar, aber alle Knöpfe fehlen.

Dann liegt er außerhalb von /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.
Nachlesen: Dockge: Compose-Stacks im Browser verwalten →

Der Stack-Name wird abgelehnt.

Erlaubt sind nur Kleinbuchstaben, Ziffern, Bindestriche und Unterstriche, weil daraus Ordner- und Compose-Projektname werden. Meine App scheitert mit Stack name can only contain [a-z][0-9] _ - only, meine-app geht.
Nachlesen: Dockge: Compose-Stacks im Browser verwalten →

Nach einem Neustart ist die Anmeldung weg.

Dann wurde ./data nicht persistent gemountet – dort liegen Datenbank und JWT-Secret. Prüfe, dass /opt/dockge/data existiert und im Compose eingebunden ist.
Nachlesen: Dockge: Compose-Stacks im Browser verwalten →

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 sourcerange und starte mit docker compose up -d neu.
Nachlesen: Audiobookshelf: Hörbücher & Podcasts selbst hosten →

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 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.
Nachlesen: Audiobookshelf: Hörbücher & Podcasts selbst hosten →

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 Autor/Titel/ – Dateien in einen Unterordner mit dem Buchtitel legen und erneut scannen.
Nachlesen: Audiobookshelf: Hörbücher & Podcasts selbst hosten →

Traefik antwortet mit 404, obwohl der Container läuft.

Meist fehlt 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.
Nachlesen: Audiobookshelf: Hörbücher & Podcasts selbst hosten →

Die Adresse springt auf /audiobookshelf/.

Das ist normal: Das Frontend wird mit diesem festen Router-Pfad ausgeliefert, und ROUTER_BASE_PATH ändert daran zur Laufzeit nichts, weil der Pfad im Image eingebaut ist. https://DEINE_DOMAIN bleibt als Einstieg gültig.
Nachlesen: Audiobookshelf: Hörbücher & Podcasts selbst hosten →

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 → Language → „Deutsch" setzen.
Nachlesen: Audiobookshelf: Hörbücher & Podcasts selbst hosten →

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 sourcerange und starte mit docker compose up -d neu.
Nachlesen: WordPress mit Docker & Traefik sauber betreiben →

Redirect-Schleife (ERR_TOO_MANY_REDIRECTS) oder Mixed-Content-Warnungen.

Die HTTPS-Erkennung fehlt. Prüfe, dass der 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.
Nachlesen: WordPress mit Docker & Traefik sauber betreiben →

WordPress startet nicht, meldet „Error establishing a database connection“.

Meist eine Race Condition oder ein Passwort-Mismatch. Prüfe, dass depends_on: condition: service_healthy gesetzt ist und WORDPRESS_DB_PASSWORD exakt MARIADB_PASSWORD entspricht. Logs: docker compose logs db.
Nachlesen: WordPress mit Docker & Traefik sauber betreiben →

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 docker compose up -d.
Nachlesen: WordPress mit Docker & Traefik sauber betreiben →

Medien-Uploads schlagen bei großen Dateien fehl.

PHP begrenzt die Upload-Größe. Lege eine eigene 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.
Nachlesen: WordPress mit Docker & Traefik sauber betreiben →

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).
Nachlesen: WordPress mit Docker & Traefik sauber betreiben →

Die Seite kommt nicht, Traefik antwortet mit 404, obwohl der Container läuft.

Der Healthcheck ist noch nicht 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.
Nachlesen: linkding: Lesezeichen selbst hosten →

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 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.
Nachlesen: linkding: Lesezeichen selbst hosten →

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.
Nachlesen: linkding: Lesezeichen selbst hosten →

Die API oder die Extension antwortet mit 401.

Entweder fehlt der Token, oder er ist falsch: {"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.
Nachlesen: linkding: Lesezeichen selbst hosten →

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 sourcerange und starte mit docker compose up -d neu.
Nachlesen: Navidrome: die eigene Musik streamen wie mit Spotify →

Die Bibliothek bleibt leer.

Entweder liegen keine Dateien im gemounteten 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).
Nachlesen: Navidrome: die eigene Musik streamen wie mit Spotify →

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 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.
Nachlesen: Navidrome: die eigene Musik streamen wie mit Spotify →

Neue Musik taucht nicht auf.

Der Scan läuft nur stündlich (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.
Nachlesen: Navidrome: die eigene Musik streamen wie mit Spotify →

Die App verbindet sich nicht.

Fast immer die Server-URL: Sie muss 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.
Nachlesen: Navidrome: die eigene Musik streamen wie mit Spotify →

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).
Nachlesen: Healthchecks: Cron-Jobs und Backups überwachen →

Der Container steht auf Restarting, die Domain liefert 404.

In 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.
Nachlesen: Healthchecks: Cron-Jobs und Backups überwachen →

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 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.
Nachlesen: Healthchecks: Cron-Jobs und Backups überwachen →

Der Check wird nicht „grün“, obwohl der Job läuft.

Prüfe, ob der 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.
Nachlesen: Healthchecks: Cron-Jobs und Backups überwachen →

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 sourcerange und starte mit docker compose up -d neu.
Nachlesen: Stirling-PDF: PDF-Werkzeugkasten auf dem eigenen Server →

Die Seite kommt nicht (Traefik-404), obwohl der Container läuft.

Der Healthcheck ist noch nicht 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.
Nachlesen: Stirling-PDF: PDF-Werkzeugkasten auf dem eigenen Server →

Login mit admin/stirling scheitert.

Entweder wurde das Passwort schon geändert (dann das neue nutzen), oder die Konfiguration im 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).
Nachlesen: Stirling-PDF: PDF-Werkzeugkasten auf dem eigenen Server →

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 admin und dem neuen Passwort erneut anmelden.
Nachlesen: Stirling-PDF: PDF-Werkzeugkasten auf dem eigenen Server →

Eine neu hinzugefügte OCR-Sprache erscheint nicht.

Die Anwendung liest /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.
Nachlesen: Stirling-PDF: PDF-Werkzeugkasten auf dem eigenen Server →

Office-Konvertierungen oder OCR fehlen komplett.

Dann läuft die -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.
Nachlesen: Stirling-PDF: PDF-Werkzeugkasten auf dem eigenen Server →

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 sourcerange und starte mit docker compose up -d neu.
Nachlesen: Syncthing: Dateien ohne Cloud synchronisieren →

Der Container startet nicht / Neustart-Schleife mit permission denied.

Die Rechte am config- oder data-Ordner stimmen nicht. chown -R 1000:1000 /opt/syncthing/config /opt/syncthing/data und neu starten (siehe Warnung in Schritt 1).
Nachlesen: Syncthing: Dateien ohne Cloud synchronisieren →

Der Browser meldet ein ungültiges Zertifikat, obwohl der Container läuft.

Der Healthcheck ist noch nicht 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.
Nachlesen: Syncthing: Dateien ohne Cloud synchronisieren →

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 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).
Nachlesen: Syncthing: Dateien ohne Cloud synchronisieren →

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 sourcerange und starte mit docker compose up -d neu.
Nachlesen: FreshRSS: der eigene RSS-Reader →

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 data-Verzeichnisses bei jedem Start selbst – auch bei einem aus dem Backup zurückgespielten Ordner.
Nachlesen: FreshRSS: der eigene RSS-Reader →

Feeds werden nicht automatisch aktualisiert.

Prüfe zuerst, ob der Cron-Eintrag im Container überhaupt existiert: 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.
Nachlesen: FreshRSS: der eigene RSS-Reader →

Die Handy-App verbindet sich nicht und meldet einen Serverfehler.

Antwortet 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.
Nachlesen: FreshRSS: der eigene RSS-Reader →

Ein Feed aus dem eigenen Netz bleibt leer.

Seit 1.30 blockiert FreshRSS lokale Ziele; im Protokoll steht 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.
Nachlesen: FreshRSS: der eigene RSS-Reader →

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 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.
Nachlesen: systemd verstehen: Units, Journal & Timer (statt Cron) →

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 /etc/systemd/system/ gilt: systemctl daemon-reload.
Nachlesen: systemd verstehen: Units, Journal & Timer (statt Cron) →

Der Timer taucht in list-timers nicht auf.

Er wurde nicht aktiviert. systemctl enable --now DIENST.timer – und daran denken, dass der Timer den Service auslöst, du also beide Dateien brauchst (.service und .timer).
Nachlesen: systemd verstehen: Units, Journal & Timer (statt Cron) →

systemctl enable antwortet „The unit files have no installation config".

Der Unit fehlt der Abschnitt [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.
Nachlesen: systemd verstehen: Units, Journal & Timer (statt Cron) →

Das Journal ist riesig / frisst Platz.

Standardmäßig wächst es begrenzt, aber du kannst es beschneiden: journalctl --vacuum-time=14d löscht Einträge älter als 14 Tage, journalctl --disk-usage zeigt den Verbrauch.
Nachlesen: systemd verstehen: Units, Journal & Timer (statt Cron) →

„Host validation failed" statt Dashboard.

Die häufigste Stolperfalle: HOMEPAGE_ALLOWED_HOSTS fehlt oder enthält die falsche Domain. Genau die Domain eintragen, unter der du zugreifst, dann docker compose up -d.
Nachlesen: Homepage: Dashboard für deine selbstgehosteten Dienste →

Die Ressourcen-Widgets zeigen keine oder falsche Werte.

CPU und RAM liest Homepage aus dem Container heraus (kein Socket nötig). Zeigt 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).
Nachlesen: Homepage: Dashboard für deine selbstgehosteten Dienste →

Ein Icon wird nicht geladen.

Der Name passt nicht zum Icon-Katalog. Schreibe den Dienstnamen klein und ohne Leerzeichen (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.
Nachlesen: Homepage: Dashboard für deine selbstgehosteten Dienste →

Die Container-Kachel zeigt keinen Status.

Der Wert bei 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).
Nachlesen: Homepage: Dashboard für deine selbstgehosteten Dienste →

Änderungen an den YAML-Dateien greifen nicht.

Geht es um Titel oder Layout aus der 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).
Nachlesen: Homepage: Dashboard für deine selbstgehosteten Dienste →

Statt der Anmeldemaske kommt „Authentication error – Auth is disabled or misconfigured".

Dann ist 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.
Nachlesen: Homepage: Dashboard für deine selbstgehosteten Dienste →

Der Container bleibt unhealthy.

Fast immer der IPv6-Fallstrick aus Schritt 4: Der Healthcheck fragt 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.
Nachlesen: Die eigene Website mit Hugo hosten →

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 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.
Nachlesen: Die eigene Website mit Hugo hosten →

Alle Links und Bilder sind kaputt.

Die baseURL in hugo.toml stimmt nicht mit der echten Domain überein. Hugo backt absolute URLs auf Basis dieses Werts ein – korrigieren und neu bauen.
Nachlesen: Die eigene Website mit Hugo hosten →

Ein Beitrag erscheint nicht.

Prüfe das 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.
Nachlesen: Die eigene Website mit Hugo hosten →

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 .dockerignore ihn ausschließt. Theme wie in Schritt 1 als echten Ordner ablegen.
Nachlesen: Die eigene Website mit Hugo hosten →

Container erreicht anderen nicht per Name (bad address).

Beide hängen nicht im selben benannten Netz, oder einer nutzt das Standard-bridge (kein DNS). Prüfe mit docker inspect -f '{{range $k,$v := .NetworkSettings.Networks}}{{$k}} {{end}}' CONTAINER, in welchen Netzen ein Container hängt.
Nachlesen: Docker-Netzwerke verstehen: bridge, DNS & proxy-Netz →

Traefik gibt 502 Bad Gateway.

Fast immer sind Traefik und die App in verschiedenen 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.
Nachlesen: Docker-Netzwerke verstehen: bridge, DNS & proxy-Netz →

network proxy declared as external, but could not be found beim up.

Das externe Netz existiert noch nicht. Einmalig anlegen: 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.
Nachlesen: Docker-Netzwerke verstehen: bridge, DNS & proxy-Netz →

Datenbank hat trotz internal Internet.

Sie hängt zusätzlich in einem nicht-internen Netz (z. B. proxy). Ein Container hat die Summe der Zugriffe aller seiner Netze – die DB gehört nur ins interne Netz, nie ins proxy-Netz.
Nachlesen: Docker-Netzwerke verstehen: bridge, DNS & proxy-Netz →

Zwei Stacks kollidieren beim Subnetz.

Docker vergibt 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.
Nachlesen: Docker-Netzwerke verstehen: bridge, DNS & proxy-Netz →

Permission denied, obwohl die Rechte stimmen.

Prüfe die Rechte des übergeordneten Verzeichnisses: Fehlt dort das x-Recht, kommst du gar nicht erst an die Datei heran, egal wie ihre eigenen Rechte aussehen. ls -ld /pfad/zum/ordner zeigt es.
Nachlesen: Linux-Benutzer, Gruppen & Dateirechte verstehen →

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). id in der neuen Sitzung muss docker anzeigen.
Nachlesen: Linux-Benutzer, Gruppen & Dateirechte verstehen →

Neue Dateien haben unerwartete Rechte.

Das bestimmt die 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).
Nachlesen: Linux-Benutzer, Gruppen & Dateirechte verstehen →

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: chown -R 1000:1000 ./data – die richtige UID nennt die Doku des Images (Umgebungsvariablen wie PUID/PGID).
Nachlesen: Linux-Benutzer, Gruppen & Dateirechte verstehen →

usermod hat den Benutzer aus Gruppen geworfen.

Du hast -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.
Nachlesen: Linux-Benutzer, Gruppen & Dateirechte verstehen →

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 XLM-…- oder SigLIP2-Modell wechseln und neu indexieren.
Nachlesen: Immich optimieren: Handy-Backup & KI-Suche (Teil 2) →

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 (/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.
Nachlesen: Immich optimieren: Handy-Backup & KI-Suche (Teil 2) →

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 (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.
Nachlesen: Wie HTTPS funktioniert und was Traefik dir abnimmt →

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, acme.json leeren, Container neu starten (Details im Traefik-Tutorial).
Nachlesen: Wie HTTPS funktioniert und was Traefik dir abnimmt →

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 acme.json ins Backup nehmen, statt Zertifikate neu auszustellen.
Nachlesen: Wie HTTPS funktioniert und was Traefik dir abnimmt →

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: apt update && apt install ca-certificates.
Nachlesen: Wie HTTPS funktioniert und was Traefik dir abnimmt →

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 sourcerange und starte mit docker compose up -d neu.
Nachlesen: AdGuard Home: Werbeblocker fürs ganze Netz →

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.
Nachlesen: AdGuard Home: Werbeblocker fürs ganze Netz →

docker compose up scheitert mit „cannot assign requested address" für 10.8.0.1.

Das WireGuard-Interface 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.
Nachlesen: AdGuard Home: Werbeblocker fürs ganze Netz →

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 ./conf/AdGuardHome.yaml unter http: die address auf 0.0.0.0:3000 korrigieren und docker compose restart.
Nachlesen: AdGuard Home: Werbeblocker fürs ganze Netz →

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 dig @10.8.0.1 … (greift immer).
Nachlesen: AdGuard Home: Werbeblocker fürs ganze Netz →

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 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.
Nachlesen: Forgejo Actions: eigener CI/CD-Runner mit Docker →

Der Job startet, scheitert aber beim actions/checkout mit einem Verbindungsfehler.

Der Runner wurde mit einer internen Instanz-URL (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).
Nachlesen: Forgejo Actions: eigener CI/CD-Runner mit Docker →

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 https://DEINE_DOMAIN erreicht (docker compose run --rm runner wget -qO- https://DEINE_DOMAIN/api/healthz).
Nachlesen: Forgejo Actions: eigener CI/CD-Runner mit Docker →

Ein Job bleibt ewig „wartend" (pending).

Kein Runner hat ein passendes Label. Der Workflow nutzt 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.
Nachlesen: Forgejo Actions: eigener CI/CD-Runner mit Docker →

actions/checkout findet die Action nicht.

Forgejo lädt Actions aus einem konfigurierten Register (standardmäßig 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.
Nachlesen: Forgejo Actions: eigener CI/CD-Runner mit Docker →

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 mail.DEINE_DOMAIN setzen, mit dig -x prüfen und sicherstellen, dass der Name vorwärts auf dieselbe IP zeigt.
Nachlesen: E-Mail-Zustellbarkeit: SPF, DKIM, DMARC und PTR →

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 (SELECTOR._domainkey) mit dem im Server konfigurierten abgleichen, dann dig gegenprüfen. Zwei Blöcke in Anführungszeichen sind dabei normal, siehe Schritt 3.
Nachlesen: E-Mail-Zustellbarkeit: SPF, DKIM, DMARC und PTR →

SPF „permerror" oder „too many DNS lookups".

Mehrere SPF-Records, oder zu viele 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.
Nachlesen: E-Mail-Zustellbarkeit: SPF, DKIM, DMARC und PTR →

Mails an Outlook/Hotmail landen im Spam oder werden abgewiesen.

Eine harte Abweisung mit 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.
Nachlesen: E-Mail-Zustellbarkeit: SPF, DKIM, DMARC und PTR →

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. 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.
Nachlesen: Stalwart: der schlanke Mailserver in einem Container →

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 http://…:8080/admin, direkt per IP oder über einen SSH-Tunnel auf localhost:8080.
Nachlesen: Stalwart: der schlanke Mailserver in einem Container →

Die Anmeldung scheitert mit „Unknown client id“.

Du rufst die Konsole über 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.
Nachlesen: Stalwart: der schlanke Mailserver in einem Container →

Ich habe das Bootstrap-Passwort verpasst.

Solange der Assistent nicht abgeschlossen ist, reicht ein 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.
Nachlesen: Stalwart: der schlanke Mailserver in einem Container →

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: 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.
Nachlesen: Stalwart: der schlanke Mailserver in einem Container →

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 sourcerange und starte mit docker compose up -d neu.
Nachlesen: Eigener Mailserver mit Mailcow: Setup von Grund auf →

Die Oberfläche zeigt nur Fatal error: … Failed opening required '/web/inc/app_info.inc.php'.

Der Generator lief ohne 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.
Nachlesen: Eigener Mailserver mit Mailcow: Setup von Grund auf →

generate_config.sh bricht mit Cannot find command 'jq' ab.

Das Paket jq fehlt. sudo apt install -y jq und den Generator erneut starten.
Nachlesen: Eigener Mailserver mit Mailcow: Setup von Grund auf →

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 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.
Nachlesen: Eigener Mailserver mit Mailcow: Setup von Grund auf →

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 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.
Nachlesen: Eigener Mailserver mit Mailcow: Setup von Grund auf →

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 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.
Nachlesen: Eigener Mailserver mit Mailcow: Setup von Grund auf →

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 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.
Nachlesen: Eigener Mailserver mit Mailcow: Setup von Grund auf →

Hinter Traefik zeigen Mailprogramme ein selbst signiertes Zertifikat.

Der Dumper hat nichts geschrieben oder Postfix und Dovecot nicht neu gestartet. 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}}'.
Nachlesen: Eigener Mailserver mit Mailcow: Setup von Grund auf →

Container starten träge oder werden vom Kernel beendet (OOM).

Zu wenig RAM. Auf mindestens 6–8 GB gehen oder ClamAV in der mailcow.conf (SKIP_CLAMD=y) deaktivieren – der Virenscanner ist der größte Speicherfresser.
Nachlesen: Eigener Mailserver mit Mailcow: Setup von Grund auf →

Die App meldet „Cannot connect" oder der Web-Client bleibt leer.

Die 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.
Nachlesen: ntfy: Push-Benachrichtigungen aufs Handy →

curl liefert HTTP 401 oder 403.

Bei 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.
Nachlesen: ntfy: Push-Benachrichtigungen aufs Handy →

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 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").
Nachlesen: ntfy: Push-Benachrichtigungen aufs Handy →

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 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.
Nachlesen: ntfy: Push-Benachrichtigungen aufs Handy →

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 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.
Nachlesen: Docker-Volumes vs. Bind-Mounts: wo die Daten liegen →

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 (chown -R 1000:1000 /opt/app/data) oder per user: in der compose.yaml die UID setzen, unter der der Container läuft.
Nachlesen: Docker-Volumes vs. Bind-Mounts: wo die Daten liegen →

Docker-Volumes vs. Bind-Mounts: Nach docker compose down sind alle Daten weg.

Du hast 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.
Nachlesen: Docker-Volumes vs. Bind-Mounts: wo die Daten liegen →

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.
Nachlesen: Docker-Volumes vs. Bind-Mounts: wo die Daten liegen →

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 sourcerange und starte mit docker compose up -d neu.
Nachlesen: Matomo cookielos selbst hosten, ohne Consent-Banner →

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 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.
Nachlesen: Matomo cookielos selbst hosten, ohne Consent-Banner →

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 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.
Nachlesen: Matomo cookielos selbst hosten, ohne Consent-Banner →

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 config/config.ini.php ein.
Nachlesen: Matomo cookielos selbst hosten, ohne Consent-Banner →

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 matomo.php rausgeht. In Matomo hilft Verwaltung → Diagnose → Tracking Fehlschläge.
Nachlesen: Matomo cookielos selbst hosten, ohne Consent-Banner →

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 SSH_PORT und SSH_LISTEN_PORT beide auf denselben Wert (hier 2222) – dann startet Forgejo sauber.
Nachlesen: Forgejo: der eigene Git-Server hinter Traefik →

Der Container braucht ewig, bis er healthy ist.

Docker führt den ersten Healthcheck standardmäßig erst nach dem 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.)
Nachlesen: Forgejo: der eigene Git-Server hinter Traefik →

Traefik liefert 502 Bad Gateway.

Fast immer der falsche Port: Forgejos Weboberfläche lauscht intern auf 3000, deshalb muss loadbalancer.server.port=3000 gesetzt sein und der Container im proxy-Netz hängen.
Nachlesen: Forgejo: der eigene Git-Server hinter Traefik →

Klon-Links zeigen localhost oder den falschen Port.

Dann stimmen ROOT_URL, SSH_DOMAIN oder SSH_PORT nicht. Korrigiere die Werte in der Compose und starte mit docker compose up -d neu.
Nachlesen: Forgejo: der eigene Git-Server hinter Traefik →

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 2222 vergessen.
Nachlesen: Forgejo: der eigene Git-Server hinter Traefik →

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 sourcerange und starte mit docker compose up -d neu.
Nachlesen: HitKeep: datenschutzfreundliche Web-Analytics →

Die Live-Tracking-Prüfung bleibt auf „Wartet" / keine Treffer im Dashboard.

Prüfe im Browser (Entwicklertools → Netzwerk), ob 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.
Nachlesen: HitKeep: datenschutzfreundliche Web-Analytics →

Alle Besucher kommen scheinbar von einer einzigen IP, Land und Provider stehen auf „(Unknown)".

Dann greift 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.
Nachlesen: HitKeep: datenschutzfreundliche Web-Analytics →

Traefik liefert 404 oder 502.

Ein 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.
Nachlesen: HitKeep: datenschutzfreundliche Web-Analytics →

Nach dem Login landest du wieder auf der Anmeldeseite (Login-Schleife).

Das ist fast immer eine Diskrepanz bei 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.
Nachlesen: HitKeep: datenschutzfreundliche Web-Analytics →

Der Container startet nicht bzw. ist nicht healthy.

Sieh in die Logs: 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.
Nachlesen: HitKeep: datenschutzfreundliche Web-Analytics →

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: 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.
Nachlesen: WireGuard-VPN: sicherer Zugang zum eigenen Server →

Handshake ist da, aber im Full-Tunnel kommt kein Internet an.

Fast immer das Routing/NAT. Ist 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)?
Nachlesen: WireGuard-VPN: sicherer Zugang zum eigenen Server →

Full-Tunnel steht, aber curl -s ifconfig.me zeigt deine eigene Adresse.

Ist es eine IPv6-Adresse, fehlt ::/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.
Nachlesen: WireGuard-VPN: sicherer Zugang zum eigenen Server →

Full-Tunnel steht, aber DNS-Anfragen laufen weiter am Tunnel vorbei (DNS-Leak).

Ohne 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.
Nachlesen: WireGuard-VPN: sicherer Zugang zum eigenen Server →

Der Tunnel steht, aber große Übertragungen (SSH, HTTPS, Downloads) hängen oder brechen ab.

Ein MTU-Problem. 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.
Nachlesen: WireGuard-VPN: sicherer Zugang zum eigenen Server →

wg-quick up meldet resolvconf: command not found.

Die DNS =-Zeile braucht resolvconf. Entweder sudo apt install openresolv installieren oder die DNS-Zeile entfernen, wenn du den VPN-DNS nicht brauchst.
Nachlesen: WireGuard-VPN: sicherer Zugang zum eigenen Server →

Die Verbindung schläft ein, sobald das Handy kurz nichts sendet.

Der Client sitzt hinter NAT/CGNAT. PersistentKeepalive = 25 in der Client-Konfig hält die Verbindung offen.
Nachlesen: WireGuard-VPN: sicherer Zugang zum eigenen Server →

Deine Werte liegen deutlich unter unseren, besonders bei der CPU.

Ein VPS teilt sich die physische CPU. Prüfe die Steal Time (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.
Nachlesen: netcup VPS 1000 G12 im Benchmark: wie schnell ist er? →

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 --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.
Nachlesen: netcup VPS 1000 G12 im Benchmark: wie schnell ist er? →

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 curl-Stream schöpft zudem nicht immer die volle Bandbreite aus.
Nachlesen: netcup VPS 1000 G12 im Benchmark: wie schnell ist er? →

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 (: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.
Nachlesen: Den ganzen Docker-Stack sicher aktuell halten →

Die App startet nach dem Update nicht mehr oder wirft Datenbank-Fehler.

Meist ein Breaking Change oder eine fehlgeschlagene Migration. Prüfe 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.
Nachlesen: Den ganzen Docker-Stack sicher aktuell halten →

Diun meldet nichts, obwohl Updates existieren.

Prüfe, dass die Container das Label 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.
Nachlesen: Den ganzen Docker-Stack sicher aktuell halten →

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.
Nachlesen: Den ganzen Docker-Stack sicher aktuell halten →

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.
Nachlesen: Den ganzen Docker-Stack sicher aktuell halten →

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 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.
Nachlesen: CrowdSec: moderne, kollaborative Angriffsabwehr →

Nach dem Neustart von Traefik bekommt jede App 403 – auch du selbst.

Der Bouncer erreicht die LAPI nicht; im Traefik-Log steht 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).
Nachlesen: CrowdSec: moderne, kollaborative Angriffsabwehr →

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 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.
Nachlesen: CrowdSec: moderne, kollaborative Angriffsabwehr →

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 modulename und version exakt stimmen.
Nachlesen: CrowdSec: moderne, kollaborative Angriffsabwehr →

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 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.
Nachlesen: CrowdSec: moderne, kollaborative Angriffsabwehr →

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.
Nachlesen: Die wichtigsten Terminal-Befehle für deinen Server →

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.
Nachlesen: Die wichtigsten Terminal-Befehle für deinen Server →

rsync hat viel mehr kopiert (oder gelöscht) als erwartet.

Der abschließende Schrägstrich entscheidet: 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.
Nachlesen: Die wichtigsten Terminal-Befehle für deinen Server →

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 iotop brauchen zudem sudo, um überhaupt Daten zu sehen.
Nachlesen: Die wichtigsten Terminal-Befehle für deinen Server →

Nach tmux ist bei erneutem Login „alles weg".

Du hast eine neue Sitzung gestartet statt dich anzuhängen. tmux ls listet laufende Sitzungen, tmux attach -t 0 hängt dich an die erste. Nur tmux allein erzeugt jedes Mal eine frische.
Nachlesen: Die wichtigsten Terminal-Befehle für deinen Server →

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 sourcerange und starte mit docker compose up -d neu.
Nachlesen: Jellyfin selbst hosten: eigener Medienserver →

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 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.
Nachlesen: Jellyfin selbst hosten: eigener Medienserver →

Die Bibliotheken bleiben leer, obwohl Dateien da sind.

Fast immer ein Rechte-Problem. Der Container läuft als 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".
Nachlesen: Jellyfin selbst hosten: eigener Medienserver →

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 fstab-Eintrag (Schritt 2). Prüfe mit df -h /mnt/media und sudo mount -a. Die Zeile muss die UUID verwenden, nicht /dev/vdb1.
Nachlesen: Jellyfin selbst hosten: eigener Medienserver →

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).
Nachlesen: Jellyfin selbst hosten: eigener Medienserver →

Ein Target steht in Prometheus auf up = 0 bzw. „DOWN".

Prometheus erreicht den Exporter nicht. Bei 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.
Nachlesen: Monitoring mit Grafana & Prometheus: Live-Dashboards →

Das cAdvisor-Dashboard zeigt teils „No data" oder cAdvisor startet nicht.

Fehlen die Mounts oder 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.
Nachlesen: Monitoring mit Grafana & Prometheus: Live-Dashboards →

Grafana lädt hinter Traefik nicht richtig – Login schlägt fehl oder das Layout ist kaputt.

Fast immer stimmt 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.
Nachlesen: Monitoring mit Grafana & Prometheus: Live-Dashboards →

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 (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.
Nachlesen: Monitoring mit Grafana & Prometheus: Live-Dashboards →

Der Speicherplatz auf dem Server wächst stetig.

Das ist die Prometheus-TSDB. Reduziere --storage.tsdb.retention.time (z. B. auf 15d) oder überwache weniger Ziele. Das prom_data-Volume wächst mit Anzahl der Metriken × Vorhaltezeit.
Nachlesen: Monitoring mit Grafana & Prometheus: Live-Dashboards →

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 sourcerange und starte mit docker compose up -d neu.
Nachlesen: Immich selbst hosten: privates Foto-Backup →

Uploads großer Videos brechen nach etwa einer Minute ab (Fehler 502 oder 499).

Traefiks 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.
Nachlesen: Immich selbst hosten: privates Foto-Backup →

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 immich-machine-learning aus der compose.yaml entfernst. Immich läuft dann ohne Gesichtserkennung und intelligente Suche, aber Upload und Zeitleiste funktionieren normal.
Nachlesen: Immich selbst hosten: privates Foto-Backup →

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 .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.
Nachlesen: Immich selbst hosten: privates Foto-Backup →

Immich zeigt „Wartungsmodus" / „Vorübergehend nicht verfügbar".

Immich v3 startet bei bestimmten Datenbank-Zuständen in einen Wartungsmodus. Im Log (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.
Nachlesen: Immich selbst hosten: privates Foto-Backup →

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.
Nachlesen: Immich selbst hosten: privates Foto-Backup →

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.
Nachlesen: Paperless-ngx selbst hosten: papierloses Büro mit OCR →

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 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.
Nachlesen: Paperless-ngx selbst hosten: papierloses Büro mit OCR →

Hochgeladene Dokumente bleiben „in Bearbeitung" hängen.

Die Hintergrundverarbeitung läuft über den Broker. Prüfe, dass der 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.
Nachlesen: Paperless-ngx selbst hosten: papierloses Büro mit OCR →

Die Texterkennung liefert Unsinn oder erkennt nichts.

Falsche OCR-Sprache. Setz PAPERLESS_OCR_LANGUAGE=deu (oder deu+eng für gemischte Dokumente). Nur installierte Sprachen funktionieren.
Nachlesen: Paperless-ngx selbst hosten: papierloses Büro mit OCR →

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 PAPERLESS_TIKA_ENABLED=1 samt der beiden Endpoint-Variablen gesetzt ist.
Nachlesen: Paperless-ngx selbst hosten: papierloses Büro mit OCR →

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 (PAPERLESS_TASK_WORKERS, PAPERLESS_THREADS_PER_WORKER). Dann dauert der Import länger, aber die Oberfläche bleibt bedienbar.
Nachlesen: Paperless-ngx selbst hosten: papierloses Büro mit OCR →

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 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.
Nachlesen: Nextcloud absichern & optimieren (Teil 2) →

Der E-Mail-Test schlägt fehl („Es gab ein Problem beim Senden der E-Mail").

Fast immer Port/Verschlüsselung oder Authentifizierung. Kombiniere 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.
Nachlesen: Nextcloud absichern & optimieren (Teil 2) →

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: docker exec -u www-data nc-app php occ twofactorauth:enforce --off.
Nachlesen: Nextcloud absichern & optimieren (Teil 2) →

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.
Nachlesen: Nextcloud absichern & optimieren (Teil 2) →

Nach einem Reboot meldet Nextcloud „Redis went away" oder wird sehr langsam.

Der App-Container ist vor Redis gestartet. Stelle sicher, dass nc-redis in depends_on steht (Teil 1) und mit restart: unless-stopped läuft – dann fängt Docker den Startreihenfolge-Fall selbst ab.
Nachlesen: Nextcloud absichern & optimieren (Teil 2) →

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 sourcerange und starte mit docker compose up -d neu.
Nachlesen: Nextcloud selbst hosten: deine eigene Cloud →

„Zugriff über eine nicht vertrauenswürdige Domäne" statt der Login-Seite.

Deine Domain steht nicht in 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.
Nachlesen: Nextcloud selbst hosten: deine eigene Cloud →

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 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.
Nachlesen: Nextcloud selbst hosten: deine eigene Cloud →

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: 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).
Nachlesen: Nextcloud selbst hosten: deine eigene Cloud →

Große Uploads brechen ab oder enden mit einem Timeout / „413".

Das PHP-Limit ist zu klein. Erhöhe 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.
Nachlesen: Nextcloud selbst hosten: deine eigene Cloud →

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 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.
Nachlesen: Nextcloud selbst hosten: deine eigene Cloud →

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 sourcerange und starte mit docker compose up -d neu.
Nachlesen: Uptime Kuma: Server-Monitoring hinter Traefik →

Bad Gateway (502) beim Aufruf von status.DEINE_DOMAIN.

Fast immer fehlt das Port-Label 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.
Nachlesen: Uptime Kuma: Server-Monitoring hinter Traefik →

404 page not found statt Kuma.

Wie bei jeder App 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.
Nachlesen: Uptime Kuma: Server-Monitoring hinter Traefik →

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 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.
Nachlesen: Uptime Kuma: Server-Monitoring hinter Traefik →

Der Container beendet sich sofort wieder, das Log sagt No persistent volume!.

Es fehlt das 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.
Nachlesen: Vaultwarden: eigener Passwortmanager hinter Traefik →

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 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.
Nachlesen: Vaultwarden: eigener Passwortmanager hinter Traefik →

Das Admin-Panel weist dein Passwort ab, obwohl es stimmt.

Vermutlich sind die Dollarzeichen im 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.
Nachlesen: Vaultwarden: eigener Passwortmanager hinter Traefik →

Die Handy-App findet den Server nicht oder meldet „Server-URL ungültig".

Die Server-URL muss die vollständige 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.
Nachlesen: Vaultwarden: eigener Passwortmanager hinter Traefik →

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 docker compose up -d neu.
Nachlesen: Vaultwarden: eigener Passwortmanager hinter Traefik →

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 Allowed origins are:-Zeile im --debug-Lauf. Erscheinen dort keine Security-Origins, stimmt das Origins-Pattern aus Schritt 3 nicht.
Nachlesen: Automatische Sicherheitsupdates mit unattended-upgrades →

Updates kommen, aber der Server startet trotz Kernel-Update nie neu.

Meist steht 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).
Nachlesen: Automatische Sicherheitsupdates mit unattended-upgrades →

/boot läuft voll, Updates schlagen fehl.

Alte Kernel häufen sich an. Remove-Unused-Kernel-Packages "true" setzen (Schritt 3); einmalig aufräumen mit sudo apt autoremove --purge.
Nachlesen: Automatische Sicherheitsupdates mit unattended-upgrades →

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 sudo apt upgrade und prüfst, was passiert.
Nachlesen: Automatische Sicherheitsupdates mit unattended-upgrades →

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.
Nachlesen: Fail2ban: Brute-Force-Angriffe automatisch blocken →

fail2ban.service startet nicht (systemctl status zeigt „failed").

Fast immer ein Tippfehler in jail.local. Prüfe die Syntax mit sudo fail2ban-client -t (Testmodus) – der Befehl nennt die fehlerhafte Zeile.
Nachlesen: Fail2ban: Brute-Force-Angriffe automatisch blocken →

Deine Werte aus jail.local greifen nicht.

Es wird nur 10 Minuten gesperrt, oder die eigene IP fliegt trotz 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.
Nachlesen: Fail2ban: Brute-Force-Angriffe automatisch blocken →

Es wird nie jemand gesperrt, obwohl das Log voller Fehlversuche ist.

Prüfe mit 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).
Nachlesen: Fail2ban: Brute-Force-Angriffe automatisch blocken →

Sperren „wirken" nicht – die IP verbindet sich weiter.

Auf Debian 13 sperrt Fail2ban per nftables (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.
Nachlesen: Fail2ban: Brute-Force-Angriffe automatisch blocken →

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 (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.
Nachlesen: Restic-Backups einrichten: verschlüsselt und off-site →

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.
Nachlesen: Restic-Backups einrichten: verschlüsselt und off-site →

repository is already locked.

Ein abgebrochener Lauf hat eine Sperre hinterlassen. Prüfe, dass wirklich kein Backup mehr läuft, dann restic unlock. Niemals blind entsperren, während parallel ein Lauf aktiv ist.
Nachlesen: Restic-Backups einrichten: verschlüsselt und off-site →

Das Backup wird riesig / sichert Unsinn.

Grenze mit --exclude/--exclude-file ein (Caches, Logs, temporäre Dateien) und nutze --one-file-system, damit Restic nicht in gemountete Fremd-Dateisysteme abtaucht.
Nachlesen: Restic-Backups einrichten: verschlüsselt und off-site →

prune dauert ewig oder wurde abgebrochen.

Kein Grund zur Panik – 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).
Nachlesen: Restic-Backups einrichten: verschlüsselt und off-site →

Der Timer läuft, aber in Uptime Kuma kommt nie eine Erfolgsmeldung.

Sieh dir den letzten Lauf mit 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.
Nachlesen: Restic-Backups einrichten: verschlüsselt und off-site →

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 – 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.
Nachlesen: Traefik: Reverse Proxy mit automatischem HTTPS →

404 page not found beim Aufruf der App-Domain.

Traefik kennt die Route nicht. Prüfe: Hat der Container 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.
Nachlesen: Traefik: Reverse Proxy mit automatischem HTTPS →

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. chmod 600 acme.json nachholen (Schritt 2) und Container neu starten.
Nachlesen: Traefik: Reverse Proxy mit automatischem HTTPS →

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 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.
Nachlesen: Traefik: Reverse Proxy mit automatischem HTTPS →

Basic-Auth am Dashboard wird sofort wieder abgewiesen / Router fehlt.

In der compose.yaml müssen die $-Zeichen des Hashes verdoppelt sein ($$). Prüfe den Hash außerhalb noch einmal mit htpasswd -nbB.
Nachlesen: Traefik: Reverse Proxy mit automatischem HTTPS →

Gateway Timeout oder Traefik erreicht den Container nicht.

Meist hängt die App im falschen Netzwerk oder Traefik weiß nicht, welches gemeint ist. providers.docker.network=proxy in Traefik und networks: [proxy] an der App müssen zusammenpassen.
Nachlesen: Traefik: Reverse Proxy mit automatischem HTTPS →

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 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).
Nachlesen: Traefik: Reverse Proxy mit automatischem HTTPS →

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: 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).
Nachlesen: Docker Compose verstehen: Services, Volumes, Netzwerke →

address already in use oder port is already allocated beim up.

Der Host-Port (links in 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.
Nachlesen: Docker Compose verstehen: Services, Volumes, Netzwerke →

Eine App findet ihre Datenbank nicht (could not translate host name).

Als Hostname muss der Service-Name stehen (z. B. 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.
Nachlesen: Docker Compose verstehen: Services, Volumes, Netzwerke →

Docker Compose: Nach docker compose down sind alle Daten weg.

Entweder lag das Volume nicht als Named Volume unter 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.
Nachlesen: Docker Compose verstehen: Services, Volumes, Netzwerke →

docker-compose: command not found.

Das ist das alte Compose v1 (mit Bindestrich). Aktuell ist docker compose (mit Leerzeichen, Plugin). Falls es fehlt: sudo apt install docker-compose-plugin (siehe Docker-Tutorial).
Nachlesen: Docker Compose verstehen: Services, Volumes, Netzwerke →

dig liefert keine oder eine falsche (alte) IP.

Meist noch Propagation. Frage gezielt einen öffentlichen Resolver, der deinen lokalen Cache umgeht: dig +short DEINE_DOMAIN @1.1.1.1. Zeigt der schon den richtigen Wert, ist nur dein lokaler/Provider-Cache noch nicht abgelaufen – abwarten.
Nachlesen: Eine Domain mit dem Server verbinden (DNS-Grundlagen) →

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 (sudo ufw allow …) und teste erneut. Genau davor warnt Schritt 3.
Nachlesen: Firewall mit UFW einrichten →

ERROR: Could not find a profile matching 'OpenSSH'.

Das OpenSSH-Profil existiert nur, wenn 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.
Nachlesen: Firewall mit UFW einrichten →

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 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.
Nachlesen: Firewall mit UFW einrichten →

„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 - zeigen) und starte den Snapshot erneut.
Nachlesen: netcup SCP: Snapshots, Konsole & Rettung →

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 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.
Nachlesen: netcup SCP: Snapshots, Konsole & Rettung →

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 EINGEHEND · UDP · ACCEPT · Src 67 im Basis-Template (siehe DHCP-Tipp in Schritt 2).
Nachlesen: netcup-Firewall im SCP einrichten →

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 /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.
Nachlesen: Docker auf Debian installieren →

permission denied while trying to connect to the docker API at unix:///var/run/docker.sock.

Die docker-Gruppenmitgliedschaft greift noch nicht. SSH-Sitzung beenden und neu verbinden; groups muss danach docker enthalten. Falls nicht, Schritt 4 wiederholen.
Nachlesen: Docker auf Debian installieren →

Konflikte bei der Installation mit bereits vorhandenen Paketen.

Auf dem System ist schon eine andere Docker-Variante installiert (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.
Nachlesen: Docker auf Debian installieren →

docker compose meldet docker: unknown command: docker compose.

Das Compose-Plugin fehlt – wahrscheinlich wurde Docker früher anders installiert. sudo apt install docker-compose-plugin nachholen. Achtung: Das alte docker-compose (mit Bindestrich) ist ein anderes, veraltetes Werkzeug.
Nachlesen: Docker auf Debian installieren →

SSH fragt trotz ssh-copy-id weiter nach dem Passwort.

Meist stimmen die Dateirechte auf dem Server nicht: SSH ignoriert 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@…).
Nachlesen: SSH-Zugang absichern →

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 /etc/ssh/sshd_config.d/00-ssh-absichern.conf vorübergehend PasswordAuthentication yes, starte SSH neu und beginne wieder bei Schritt 2.
Nachlesen: SSH-Zugang absichern →

Nach dem Neustart startet der SSH-Dienst nicht mehr.

Die Konfiguration hat einen Syntaxfehler, schon ein verschriebenes 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.
Nachlesen: SSH-Zugang absichern →

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 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.
Nachlesen: SSH-Zugang absichern →

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 ssh-keygen -R DEINE_SERVER_IP und verbinde neu. Hast du nicht neu installiert, geh der Sache nach, bevor du dich verbindest.
Nachlesen: Erste Schritte mit einem netcup VPS →

sudo: command not found als neuer Benutzer.

Auf Minimal-Images fehlt das Paket manchmal. Als 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.
Nachlesen: Erste Schritte mit einem netcup VPS →