Let's Encrypt mit certbot: HTTPS für nginx einrichten
So holst Du mit certbot ein kostenloses Let's-Encrypt-Zertifikat für nginx auf Ubuntu, prüfst die automatische Erneuerung und behebst typische Fehler.
Von Nathan Base
Deine Website läuft mit nginx auf einem eigenen Server, aber der Browser zeigt noch „Nicht sicher“ an. Mit certbot holst Du Dir ein kostenloses Zertifikat von Let’s Encrypt, das es direkt in nginx einträgt und danach selbst erneuert. Hier zeige ich Dir den ganzen Weg auf Ubuntu 26.04 LTS, und vor allem, wie Du prüfst, dass die Erneuerung wirklich funktioniert, und was Du tust, wenn certbot mit einer Fehlermeldung abbricht.
Was Du vorher brauchst
Let’s Encrypt stellt ein Zertifikat nur aus, wenn es von außen nachprüfen kann, dass die Domain zu Deinem Server gehört. Dafür ruft der Prüfserver eine Datei über Port 80 ab. Daraus ergeben sich die Voraussetzungen:
- ein Server mit Ubuntu 26.04 LTS (oder 24.04), auf dem nginx läuft (
sudo apt install nginx), und ein Benutzer mitsudo-Rechten, - eine Domain, deren A-Eintrag auf die öffentliche IPv4-Adresse des Servers zeigt, und falls vorhanden ein AAAA-Eintrag auf die richtige IPv6-Adresse,
- offene Ports 80 und 443, sowohl in der Firewall auf dem Server als auch in einer eventuellen Firewall Deines Hosters.
Falls Du noch keinen Server hast: Bei DigitalOcean (Affiliate Link) bekommst Du ein Droplet mit Ubuntu LTS und fester IP in wenigen Minuten, über diesen Link mit Startguthaben. Wie Du die Domain auf den Server zeigen lässt und mit dig kontrollierst, ob der Eintrag schon weltweit ankommt, erklärt DNS-Einträge erklärt: Domain auf eigenen Server zeigen.
Ersetze im ganzen Artikel deinedomain.de durch Deine echte Domain.
Schritt 1: nginx-Serverblock mit server_name anlegen
certbot sucht in der nginx-Konfiguration nach dem Block, dessen server_name zu Deiner Domain passt, und trägt das Zertifikat genau dort ein. Fehlt dieser Block, weiß certbot nicht, wohin damit. Leg deshalb eine eigene Datei an:
sudo nano /etc/nginx/sites-available/deinedomain.deFüge diesen Inhalt ein:
server {
listen 80;
listen [::]:80;
server_name deinedomain.de www.deinedomain.de;
root /var/www/deinedomain.de;
index index.html;
location / {
try_files $uri $uri/ =404;
}
}server_name nennt alle Namen, für die das Zertifikat gelten soll, hier die Domain mit und ohne www. root ist der Ordner mit Deinen Webseiten. Läuft hinter nginx eine Anwendung als Reverse Proxy, steht in location / stattdessen Deine proxy_pass-Zeile, für certbot macht das keinen Unterschied. Speichere mit Strg + O, bestätige mit Enter und schließe den Editor mit Strg + X.
Jetzt legen wir den Ordner für die Webseiten an, schalten die Seite ein, prüfen die Syntax und laden nginx neu:
sudo mkdir -p /var/www/deinedomain.de
sudo ln -s /etc/nginx/sites-available/deinedomain.de /etc/nginx/sites-enabled/
sudo nginx -t
sudo systemctl reload nginxnginx -t muss mit syntax is ok und test is successful antworten. Nutzt Du ufw als Firewall, gibst Du zum Schluss die beiden Ports frei:
sudo ufw allow 80/tcp
sudo ufw allow 443/tcpPort 80 bleibt auch nach der Umstellung auf HTTPS offen, denn darüber laufen die Prüfungen bei jeder Erneuerung.
Schritt 2: certbot per Snap installieren
Ubuntu hat certbot zwar auch in den apt-Quellen, aber dort bleibt die Version auf dem Stand des Release-Zeitpunkts: Ubuntu 26.04 liefert certbot 4.0.0, während das offizielle Snap im November 2026 bei Version 5.10 steht und sich selbst aktuell hält. Die offizielle certbot-Anleitung für nginx empfiehlt deshalb das Snap. snapd ist auf Ubuntu Server bereits vorinstalliert.
Hast Du früher schon certbot über apt installiert, entferne es zuerst, damit sich die beiden Versionen nicht in die Quere kommen:
sudo apt remove certbotMeldet apt, dass das Paket nicht installiert ist, ist alles in Ordnung. Dann installierst Du certbot und legst den Link an, den die offizielle Anleitung vorsieht:
sudo snap install --classic certbot
sudo ln -s /snap/bin/certbot /usr/local/bin/certbot
certbot --versionDie letzte Zeile gibt die installierte Version aus, zum Beispiel certbot 5.10.0.
Schritt 3: Zertifikat holen und in nginx eintragen
Jetzt kommt der eigentliche Schritt. Gib jede Domain aus Deinem server_name mit einem eigenen -d an:
sudo certbot --nginx -d deinedomain.de -d www.deinedomain.deBeim ersten Aufruf stellt certbot zwei Fragen. Zuerst fragt es nach einer E-Mail-Adresse. Die kannst Du angeben oder mit Enter überspringen, denn seit Juni 2025 verschickt Let’s Encrypt keine Ablauf-Erinnerungen mehr und speichert die Adresse auch nicht mehr am Konto. Danach bestätigst Du die Nutzungsbedingungen mit Y.
certbot legt dann eine Prüfdatei an, Let’s Encrypt ruft sie über Port 80 ab, und nach wenigen Sekunden steht das Zertifikat bereit. Eine erfolgreiche Ausgabe enthält diese Zeilen:
Successfully received certificate.
Certificate is saved at: /etc/letsencrypt/live/deinedomain.de/fullchain.pem
Key is saved at: /etc/letsencrypt/live/deinedomain.de/privkey.pem
...
Successfully deployed certificate for deinedomain.de to /etc/nginx/sites-enabled/deinedomain.de
Successfully deployed certificate for www.deinedomain.de to /etc/nginx/sites-enabled/deinedomain.deDabei passiert mehr, als die Ausgabe verrät. certbot ändert Deine Konfigurationsdatei so, dass der ursprüngliche Block auf Port 443 mit dem Zertifikat lauscht, und hängt einen zweiten Block für Port 80 an, der jeden Aufruf per 301 auf HTTPS umleitet. Diese Weiterleitung richtet certbot ohne Rückfrage ein. Alle geänderten Zeilen tragen den Kommentar # managed by Certbot, sodass Du sie später wiedererkennst. nginx lädt certbot selbst neu.
Schritt 4: Prüfen, ob HTTPS wirklich läuft
Ruf https://deinedomain.de im Browser auf, das Schloss in der Adresszeile ist das erste Zeichen. Genauer geht es im Terminal, auf dem Server oder auf Deinem eigenen Rechner:
curl -I http://deinedomain.deDie erste Zeile der Antwort muss HTTP/1.1 301 Moved Permanently lauten, dazu eine Zeile Location: https://deinedomain.de/. Welches Zertifikat nginx ausliefert und wie lange es gilt, zeigt dieser Befehl:
echo | openssl s_client -connect deinedomain.de:443 -servername deinedomain.de 2>/dev/null | openssl x509 -noout -issuer -datesIn der Zeile issuer steht O=Let's Encrypt, und notAfter nennt das Ablaufdatum. Welche Zertifikate certbot verwaltet, listet sudo certbot certificates auf. Die Zeile Expiry Date zeigt das Ablaufdatum und in Klammern, wie viele Tage noch übrig sind.
Schritt 5: Die automatische Erneuerung kontrollieren
Ein Zertifikat von Let’s Encrypt gilt derzeit 90 Tage. Das wird kürzer: Laut Ankündigung von Let’s Encrypt sinkt die Standardlaufzeit am 10. Februar 2027 auf 64 Tage und am 16. Februar 2028 auf 45 Tage. Von Hand erneuern ist damit keine Option mehr, und das musst Du auch nicht. Das Snap richtet einen systemd-Timer ein, der zweimal am Tag certbot renew startet. Ob er aktiv ist, siehst Du hiermit:
systemctl list-timers | grep certbotIn der Ausgabe muss eine Zeile mit snap.certbot.renew.timer und dem Zeitpunkt des nächsten Laufs stehen. certbot erneuert laut Benutzerhandbuch, sobald weniger als ein Drittel der Laufzeit übrig ist, bei 90 Tagen also nach etwa 60 Tagen. Zusätzlich fragt es bei Let’s Encrypt über ARI (ACME Renewal Information) nach, ob früher erneuert werden soll. Die kürzeren Laufzeiten fängt certbot dadurch von selbst ab.
Ob die Erneuerung durchläuft, testest Du jetzt, statt es in 60 Tagen zu merken:
sudo certbot renew --dry-runDer Testlauf spielt die komplette Erneuerung gegen die Testumgebung von Let’s Encrypt durch, ändert nichts an Deinem echten Zertifikat und belastet nicht die Limits der echten Umgebung. Am Ende muss Congratulations, all simulated renewals succeeded stehen. Weil das Zertifikat über das nginx-Plugin geholt wurde, lädt certbot nginx nach jeder echten Erneuerung selbst neu, ein eigenes Reload-Skript brauchst Du nicht. Lief eine Erneuerung schief, findest Du die Details in /var/log/letsencrypt/letsencrypt.log.
Wenn certbot einen Fehler meldet
Fast alle Fehlschläge haben eine von vier Ursachen. Die Fehlermeldung verrät, welche.
Timeout during connect (likely firewall problem): Let’s Encrypt erreicht Port 80 nicht. Prüf mit sudo ufw status, ob 80/tcp auf ALLOW steht, und sieh im Kundenbereich Deines Hosters nach, ob dort eine zusätzliche Firewall Port 80 blockiert. Ein Server zu Hause hinter einem Router braucht außerdem eine Portfreigabe für 80 und 443, und die funktioniert nur mit eigener öffentlicher IPv4-Adresse. Was hilft, wenn Dein Anschluss keine hat, steht in DS-Lite und CGNAT: Server trotzdem erreichbar machen.
DNS problem: NXDOMAIN looking up A for deinedomain.de oder eine Meldung, dass die Prüfdatei nicht gefunden wurde: Die Domain zeigt (noch) nicht auf diesen Server. Kontrollier den A-Eintrag mit dig +short deinedomain.de A. Besonders tückisch ist ein veralteter AAAA-Eintrag, denn der Prüfserver von Let’s Encrypt bevorzugt IPv6, sobald es einen AAAA-Eintrag gibt. Zeigt der auf einen anderen Server, scheitert die Prüfung, obwohl IPv4 stimmt. Korrigiere oder lösche den Eintrag dann.
Could not automatically find a matching server block: In keiner aktiven nginx-Datei steht ein server_name mit genau diesem Namen. Prüf Schritt 1, vor allem den Link in sites-enabled und die Schreibweise der Domain.
too many certificates (5) already issued for this exact set of identifiers: Du hast das Zertifikat für dieselben Namen in den letzten sieben Tagen schon fünfmal geholt, meist beim Herumprobieren. Laut den Rate Limits von Let’s Encrypt lässt sich das nicht zurücksetzen, die Kapazität füllt sich nach und nach wieder auf. Bis dahin hängst Du beim Testen --dry-run an, das läuft gegen die Testumgebung. Die regulären Erneuerungen alle paar Wochen kommen diesem Limit nicht in die Quere.
Läuft HTTPS, aber nginx zeigt statt Deiner Seite nur „502 Bad Gateway“ oder „504 Gateway Timeout“, liegt das nicht am Zertifikat, sondern am Dienst hinter nginx. Wie Du die Ursache findest, zeigt nginx 502 Bad Gateway und 504 Timeout beheben.
Fertig, und was als Nächstes kommt
Deine Seite läuft jetzt über HTTPS, HTTP leitet dauerhaft um, und der Timer erneuert das Zertifikat rechtzeitig, auch wenn die Laufzeiten ab 2027 schrumpfen. Getestet habe ich die Konfiguration aus Schritt 1, das Eintragen durch das nginx-Plugin samt Weiterleitung und die Prüfbefehle mit nginx 1.28 in einem Container mit Ubuntu 26.04. Den Snap-Timer gibt es dort nicht, er entspricht der offiziellen certbot-Anleitung. Da Let’s Encrypt keine Erinnerungsmails mehr schickt, lohnt sich alle paar Wochen ein Blick auf sudo certbot certificates oder ein externer Monitor, der die Ablaufzeit Deiner Seite überwacht.
Wenn der Server neu im Internet steht, sichere ihn als Nächstes mit Linux-Server absichern: SSH-Schlüssel, ufw, fail2ban ab. Und für Dienste, die nur im Heimnetz erreichbar sein sollen und deshalb keinen offenen Port 80 haben, ist der Weg über die DNS-Challenge in Reverse Proxy mit Caddy: HTTPS für Dienste im Heimnetz die bessere Wahl.
Weiterlesen.
-
Selfhosting & WebDNS-Einträge erklärt: Domain auf eigenen Server zeigen
So zeigt Deine Domain auf Deinen Server: A, AAAA, CNAME, MX, TXT und CAA erklärt, mit Beispielzone, Prüfung per dig und den typischen Fehlern.
Nathan Base -
Raspberry Pi & LinuxLinux-Server absichern: SSH-Schlüssel, ufw, fail2ban
Neuen Linux-Server absichern, ohne Dich auszusperren: SSH-Schlüssel, Passwort-Login aus, ufw, die Docker-Falle, fail2ban und automatische Updates.
Nathan Base -
Selfhosting & WebReverse Proxy mit Caddy: HTTPS für Dienste im Heimnetz
Caddy als Reverse Proxy mit Docker: gültige Let's-Encrypt-Zertifikate für Home Assistant und Co. per DNS-Challenge, ohne Portfreigabe im Heimnetz.
Nathan Base -
Selfhosting & Webnginx 502 Bad Gateway und 504 Timeout beheben
nginx meldet 502 Bad Gateway oder 504 Gateway Timeout? So liest Du das error.log, testest das Backend direkt und behebst Port, Socket und Timeout.
Nathan Base -
Selfhosting & WebDocker belegt zu viel Speicher: sicher aufräumen
Docker füllt die Platte? So findest Du mit docker system df die Ursache, räumst Images und Build-Cache sicher auf und begrenzt wachsende Container-Logs.
Nathan Base -
Selfhosting & WebUptime Kuma einrichten: Websites und Dienste überwachen
Uptime Kuma 2 mit Docker Compose installieren, Websites und SSL-Zertifikate überwachen, per ntfy oder Telegram alarmieren und eine Statusseite anlegen.
Nathan Base