Ein TrueNAS ist in der Praxis selten „nur ein Fileserver”. Die Web-UI läuft über TLS, WebShare liefert Browser-Freigaben für Kunden aus, dazu kommen Apps wie Nextcloud, MinIO oder Syncthing — und jede dieser Oberflächen präsentiert dem Nutzer irgendwann ein Zertifikat. Wenn das selbstsignierte Default-Zertifikat gezeigt wird, kommt die Browser-Warnung. Wenn ein Zertifikat abläuft, fällt in schlechten Fällen die Replikation aus. Dieser Artikel beschreibt, wie wir in TrueNAS 25.10 Goldeye ein Let’s Encrypt Wildcard-Zertifikat per ACME holen, es den richtigen Diensten zuweisen und die Verlängerung über Jahre hinweg automatisch laufen lassen — ohne Downtime, ohne manuelle Erinnerung, ohne Browser-Warnung.
Wer das ACME-Protokoll noch nicht aus eigener Hand kennt, liest sinnvollerweise zuerst unseren Grundlagenartikel Let’s Encrypt Zertifikate mit ACME automatisieren. Dieser Beitrag hier steigt eine Stufe tiefer in die TrueNAS-Welt ein und zeigt die Teile, die in TrueNAS-spezifisch sind: der ACME-Dialog in der UI, die DNS-Authenticators, die Rolle der WebShare-Config und wie man ein Zertifikat ohne Service-Neustart für Apps austauscht.
Warum TrueNAS Let’s Encrypt braucht
Die Werkseinstellung von TrueNAS ist pragmatisch: Bei der Erstinstallation wird ein selbstsigniertes Zertifikat erzeugt, damit die Web-UI überhaupt mit HTTPS erreichbar ist. Das reicht, um ein System in Betrieb zu nehmen — aber nicht für den Alltag. Drei Gründe sprechen gegen das Default-Zertifikat:
Browser-Warnungen bremsen Nutzer aus. Wer regelmässig Klicks auf „Erweitert > Trotzdem fortfahren” sieht, prüft irgendwann nicht mehr, ob das Zertifikat überhaupt zum Server passt. Ein manipuliertes Zertifikat würde im Alltag niemandem mehr auffallen. Besonders unangenehm wird das bei TrueNAS WebShare, wo externe Kunden Dateien per Browser abholen — die wollen keine Zertifikatswarnung sehen.
Replikation und Integrationen brechen bei abgelaufenen Zertifikaten. TrueNAS-zu-TrueNAS Replikation, S3-Anbindungen für Backup-Tools oder Monitoring-Agenten prüfen Zertifikate strikter als Browser. Ein abgelaufenes Zertifikat auf dem Zielsystem lässt eine Replikation stillstehen.
Zertifikatsrotation ist Compliance-Thema. TLS-Zertifikate mit 90 Tagen Laufzeit sind in regulierten Branchen inzwischen Standard — und seit September 2026 setzt der CA/B-Browser-Forum-Beschluss zusätzlichen Druck Richtung kürzerer Laufzeiten. Wer Zertifikate händisch tauscht, verliert diesen Rhythmus.
Die saubere Antwort darauf heisst Let’s Encrypt mit ACME und einer DNS-Challenge, zugeordnet an alle TLS-exponierten Dienste des TrueNAS.
Voraussetzungen vor dem ACME-Setup in TrueNAS
Bevor der ACME-Dialog in TrueNAS geöffnet wird, lohnt sich ein Blick auf drei Themen, die später gerne Probleme machen:
DNS unter eigener Kontrolle. Wildcard-Zertifikate funktionieren nur über die DNS-01-Challenge. Dafür braucht TrueNAS API-Zugriff auf den DNS-Provider — konkret auf eine Zone, in der ein TXT-Record _acme-challenge.<domain> gesetzt werden darf. Cloudflare, Route53, Hetzner und einige weitere Provider werden von den TrueNAS Authenticators direkt unterstützt. Wer sein DNS bei einem Provider ohne API hat, kommt mit Let’s Encrypt per DNS-Challenge nicht weiter — in dem Fall lohnt sich ein Umzug der DNS-Zone zu einem API-fähigen Provider oder der Umweg über HTTP-01 bei einem vorgelagerten Reverse Proxy.
Reverse Proxy entscheiden. TrueNAS selbst kennt keinen HTTP-01-Validator mit externem Port 80. Wer HTTP-01 statt DNS-01 nutzen möchte, braucht einen vorgelagerten Reverse Proxy, der die Challenge beantwortet und das Zertifikat an TrueNAS weiterreicht. In vielen DATAZONE-Setups läuft dort eine OPNsense mit os-acme-client — der Ablauf ist in HAProxy + Let’s Encrypt für Multidomain-Setups auf OPNsense beschrieben. Für reine Inhouse-NAS mit nur interner Erreichbarkeit ist DNS-01 die bessere Wahl.
Namensschema vorher festlegen. Welche Hostnamen sollen auf das Zertifikat? nas.firma.de für die UI, share.firma.de für WebShare, nextcloud.firma.de für die App — oder alles als Wildcard *.firma.de? Wildcards sind bequem, aber nicht in jedes Compliance-Konzept passend. Für die meisten KMU-Setups bauen wir ein Wildcard-Zertifikat plus die Apex-Domain in einem einzigen Request.
ACME in TrueNAS 25.10 Goldeye einrichten
TrueNAS 25.10 Goldeye ist aktuell das stabile Release — die ACME-Konfiguration ist dort gegenüber den früheren CORE-Versionen aufgeräumter, aber die Grundstruktur bleibt gleich. Vier logische Schritte, die in der UI unter Credentials > Certificates zusammenlaufen:
-
ACME DNS-Authenticator anlegen. Unter ACME DNS-Authenticators > Add den Provider wählen (etwa Cloudflare) und den API-Token hinterlegen. Für Cloudflare braucht der Token nur
Zone.DNS:Editauf die konkrete Zone — nicht mehr, nicht weniger. Route53 verlangt die klassischenAccessKey/SecretKeyeines IAM-Users mitroute53:ChangeResourceRecordSetsauf die passende Hosted Zone. -
ACME-Account registrieren. TrueNAS bietet den Button Create ACME Account. Hier wird eine Mail-Adresse hinterlegt (Let’s Encrypt verschickt dort Mahnungen bei fehlschlagenden Verlängerungen) und der Account bei Let’s Encrypt registriert. Für produktive Systeme ist der Production Directory-URL richtig, für erste Tests der Staging-URL.
-
CSR erzeugen. Unter Certificates > Add > Certificate Signing Request einen CSR anlegen: Common Name auf einen Hostnamen (etwa
nas.firma.de), unter Subject Alternate Names alle weiteren Hostnamen und den Wildcard-Eintrag (*.firma.de) ergänzen. Key-Länge 4096 oder ECsecp384r1— beides nehmen die Clients zuverlässig an. -
ACME-Zertifikat anfordern. Beim CSR auf Create ACME Certificate klicken, den Authenticator aus Schritt 1 für jeden FQDN zuweisen und absenden. TrueNAS triggert nun die DNS-01-Challenge: Für jeden Hostnamen wird ein TXT-Record
_acme-challenge.<host>beim DNS-Provider gesetzt, Let’s Encrypt prüft, der Record wird wieder entfernt, das Zertifikat landet im TrueNAS-Zertifikatsspeicher.
Dauer in der Praxis: Beim ersten Durchlauf 30–120 Sekunden, abhängig davon, wie schnell der DNS-Provider die TXT-Records übernimmt. Hängt der Prozess länger, lohnt sich ein Blick in System > Advanced > Save Debug — die ACME-Logs liegen dort.
DNS-Challenge Provider im Vergleich
| Provider | API-Scope minimal | Besonderheit |
|---|---|---|
| Cloudflare | Zone.DNS:Edit auf konkrete Zone | Token-basiert, schnelle Propagation |
| AWS Route53 | route53:ChangeResourceRecordSets, Hosted Zone-ID | IAM-User mit eigenem Access Key empfehlenswert |
| Hetzner DNS | API-Token auf das Projekt | sehr knapp dokumentiert, funktioniert aber zuverlässig |
| OVHcloud | Consumer Key + App Key | Setup komplexer, Rechteverwaltung über OVH-Konsole |
| INWX | API-User + Passwort | gut geeignet für kleinere KMU-Zonen |
Wer in einem der oben erwähnten Setups einen DNS-Provider nutzt, der nicht als TrueNAS-Authenticator mitgeliefert ist, kommt in der Praxis am stabilsten über einen externen ACME-Client (acme.sh oder certbot) auf einer OPNsense oder einem kleinen Debian-Server weiter und importiert das Zertifikat anschliessend per Script in TrueNAS. Mehr dazu weiter unten.
Zertifikat an UI, WebShare und Apps zuweisen
Das Zertifikat liegt — und ist jetzt noch nirgends in Benutzung. In TrueNAS gibt es drei Stellen, an denen die Zuweisung passiert:
Web-UI. Unter System > General > GUI SSL Certificate das neue Zertifikat auswählen und speichern. TrueNAS reloaded den nginx-Dienst der UI — die laufende Session wird kurz unterbrochen (zwei bis vier Sekunden), danach ist die UI mit dem Let’s Encrypt Zertifikat erreichbar. Bei Clustern aus TrueNAS 3-Node Setups ist das pro Node einzeln zu machen; wir empfehlen den Wechsel ausserhalb des Produktivzeitfensters.
WebShare. Unter Shares > WebShare liegt die Zertifikatsauswahl pro WebShare-Instanz. Wichtig: Der auf das Zertifikat zeigende FQDN muss zu dem Hostnamen passen, über den die Nutzer WebShare erreichen — nicht zum internen TrueNAS-Hostnamen. Wer WebShare und UI auf unterschiedlichen Hostnamen betreibt (share.firma.de vs nas.firma.de), zahlt diesen Luxus damit, dass das Zertifikat beide Namen abdecken muss — entweder als Wildcard oder als Multi-SAN-Zertifikat. Praxisdetails dazu haben wir in WebShare vs Nextcloud für File Sharing ausgearbeitet.
Apps. Für TrueNAS Apps gibt es seit 25.10 Goldeye eine einheitliche Logik: Jede App, die TLS terminiert, bekommt im App-Manifest einen Verweis auf ein Zertifikat aus dem TrueNAS-Zertifikatsspeicher. Für Nextcloud, Syncthing, MinIO oder einen eigenen Reverse Proxy heisst das in der Praxis: App-Edit öffnen, unter Network Configuration > Certificate das Let’s Encrypt Zertifikat auswählen und speichern. Je nach App wird der Container neu gestartet oder nur die TLS-Konfiguration neu geladen. Welche Apps in welchem Modus laufen, ist in unserem Beitrag TrueNAS Apps-Katalog produktiv für KMU im Überblick.
Replikationstasks und S3-Target-Nutzung. Oft übersehen: Wenn TrueNAS selbst als S3-Target für ein Backup-Tool dient oder als Replikationsziel mit WebSocket-TLS, zieht sich das Zertifikat ebenfalls aus demselben Store. Nach einem Wechsel kurz prüfen, dass die passende Zuordnung noch stimmt.
Renewal-Automatik: so bleibt das Zertifikat aktuell
Let’s Encrypt stellt Zertifikate mit 90 Tagen Laufzeit aus und empfiehlt die Erneuerung ab Tag 60. TrueNAS übernimmt das automatisch, wenn der ACME-Flow von oben einmal durchläuft:
- Scheduler. TrueNAS prüft täglich einmal (standardmässig nachts), ob ein Zertifikat weniger als 30 Tage Restlaufzeit hat. Trifft das zu, wird der ACME-Flow erneut durchlaufen und das Zertifikat ersetzt.
- Dienst-Reload. Für die Web-UI genügt ein nginx-Reload — der ist in TrueNAS verdrahtet. Für Apps wird je nach Hinterlegung entweder der TLS-Terminator neu geladen oder der Container neu gestartet. WebShare lädt sein Zertifikat ohne Neustart.
- Alerting. Wenn eine Erneuerung fehlschlägt (etwa weil der DNS-Provider-Token abgelaufen ist), fliegt der Fehler in das TrueNAS Alert-System. Dort empfehlen wir dringend, Mail-Alarmierung einzurichten — ein stummer Erneuerungsfehler ist der häufigste Grund, warum Zertifikate trotz Automatik ablaufen.
Für wirklich kritische Systeme bauen wir zusätzlich einen externen Monitor, der die Restlaufzeit per openssl s_client wöchentlich prüft und bei weniger als 20 Tagen eigenständig ein Ticket aufmacht. Das ist Fallback-Logik und ersetzt die TrueNAS-Automatik nicht — es findet nur den Fall ab, in dem alles vier Stufen tief versagt.
Externer ACME-Client als Fallback
Nicht jeder DNS-Provider ist in TrueNAS integriert, und manche Compliance-Vorgaben verlangen, dass der ACME-Client ausserhalb des Storage-Systems läuft. Für diese Fälle beschreiben wir hier den sauberen Fallback:
- ACME-Client auf einer OPNsense (os-acme-client Plugin) oder einem kleinen Linux-System (
acme.shodercertbot) betreiben. - DNS-Challenge dort gegen den gewünschten Provider konfigurieren — die Palette an Providern ist bei
acme.shdeutlich grösser als in TrueNAS selbst. - Nach erfolgreichem Issue das Zertifikat via Deploy-Hook per API-Call in TrueNAS importieren. TrueNAS bietet dafür ein REST-Endpoint (
/api/v2.0/certificate) und ab 25.10 einen WebSocket-Endpoint mit TLS-Auth. - Im selben Deploy-Script die Zuweisung an UI, WebShare und Apps per API triggern. TrueNAS reloaded die betroffenen Dienste anschliessend selbst.
Dieses Pattern setzen wir vor allem bei Kunden ein, bei denen das NAS selbst keinen Internetzugang hat (abgeschottetes Backend-VLAN) oder bei denen die Zertifikate aus Policy-Gründen auf einem zentralen ACME-Host liegen müssen.
Was häufig schiefgeht und wie wir es vermeiden
Nach rund zwei Jahren Let’s Encrypt-Praxis auf TrueNAS-Systemen zieht sich eine kurze Liste typischer Stolpersteine durch die Projekte:
Token-Rotation vergessen. Ein Cloudflare- oder Route53-Token läuft nach 12 Monaten ab — Let’s Encrypt-Erneuerung bricht lautlos. Lösung: Token-Rotation an denselben Rhythmus hängen wie andere Secret-Rotations oder Token ohne Ablauf nutzen (wo zulässig).
Falscher Hostname auf WebShare. Nutzer rufen share.firma.de auf, das Zertifikat spricht aber nur nas.firma.de an. Browser verweigert. Prüfpunkt: SAN-Liste des Zertifikats mit allen tatsächlich genutzten Hostnamen abgleichen.
App-Container mit altem Zertifikat. Nach einer Erneuerung lädt der Reverse-Proxy der UI frisch, der Container einer App aber nicht — er pickt sich das Zertifikat beim Start. Lösung: App-Config mit automatischem Reload bei Zertifikatswechsel, oder bei der Erneuerung einen manuellen App-Restart im Change-Window einplanen.
Replication-Task hängt. TrueNAS-zu-TrueNAS Replikation prüft Zertifikatsketten strenger als Browser. Wenn das Ziel-Zertifikat durch ein Let’s Encrypt Zertifikat ersetzt wird, muss die Replikationsconfig neu validieren — manchmal reicht Edit > Save, manchmal ist ein Trust-Store-Update auf dem Quellsystem nötig.
Falsches Netzwerk-Fenster für DNS-01. Hat das NAS keinen DNS-Outbound (das kommt bei stark segmentierten Netzen vor), kann der eigene ACME-Client die TXT-Records nicht setzen. Hier hilft nur: entweder DNS-Outbound für das NAS freischalten, oder auf den externen ACME-Client (siehe oben) umschwenken.
Wann DATAZONE das übernimmt
Für kleine Setups mit einer handvoll Hostnamen ist das ACME-Setup in TrueNAS in gut einer Stunde erledigt. Komplexer wird es, wenn mehrere TrueNAS-Systeme ein Zertifikat teilen, wenn ein eigener Reverse Proxy davor hängt oder wenn Zertifikate aus Compliance-Gründen eine zentrale Vergabestelle brauchen. Unser TrueNAS Konfigurator kalkuliert passende Systeme inklusive HA-Pärchen, und über den TrueNAS Support begleiten wir Rollouts, in denen Let’s Encrypt mit AD-Integration, Replikation und App-Katalog zusammenspielen muss. Als autorisierter iXsystems-Partner haben wir die Herstellerkanäle, wenn die Automatik an einer Edge-Case-Stelle doch mal hakt.
FAQ zu TrueNAS und Let’s Encrypt
Reicht das Default-Zertifikat von TrueNAS für den internen Betrieb?
Für die reine Erstinbetriebnahme ja, für den Produktivbetrieb nicht. Browser-Warnungen trainieren Nutzer darauf, Zertifikatsmeldungen zu ignorieren, und Replikation sowie S3-Nutzung werden mit abgelaufenen Zertifikaten unzuverlässig. Spätestens wenn WebShare oder Apps nach aussen gehen, sollte Let’s Encrypt stehen.
Funktioniert Let’s Encrypt mit einem NAS ohne Internetzugang?
Mit HTTP-01 nein, mit DNS-01 ja — vorausgesetzt das NAS kann wenigstens zur Let’s Encrypt API und zum DNS-Provider ausgehend sprechen. Wenn das nicht gegeben ist, läuft der ACME-Client auf einem anderen System und das Zertifikat wird per API in TrueNAS importiert.
Was passiert, wenn die automatische Erneuerung fehlschlägt?
TrueNAS loggt den Fehler ins Alert-System und versucht den Flow am nächsten Tag erneut. Weil Let’s Encrypt die Erneuerung bei 60 Tagen Restlaufzeit anstösst, bleiben noch rund 30 Tage, bis das Zertifikat endgültig abläuft. Mail-Alarmierung einzurichten ist der wichtigste Schritt, damit ein Fehler nicht wochenlang unbemerkt bleibt.
Wildcard-Zertifikat oder einzelne Zertifikate pro Dienst?
Wildcards sind bequem und reduzieren Rotation-Overhead. In regulierten Branchen ist manchmal pro Dienst ein eigenes Zertifikat Pflicht — dann steigt der Verwaltungsaufwand, aber die Isolation ist höher. Für die meisten KMU-Setups ist ein Wildcard plus Apex-Domain ein guter Kompromiss.
Lässt sich der ACME-Flow von TrueNAS 25.10 Goldeye auf TrueNAS 27 übernehmen?
Nach aktuellem Stand ja — iXsystems hat die ACME-Logik in 27 nicht neu gebaut, sondern die bestehende UI-Logik übernommen und um einige Qualitätsverbesserungen ergänzt. TrueNAS 27 GA kommt Anfang Dezember 2026; für Produktivsysteme empfehlen wir aktuell weiter 25.10 Goldeye und ein Upgrade auf 27 im ersten Quartal 2027, wenn die ersten Patch-Level draussen sind.
Was ist mit CA-Pinning in Clients?
Wer Clients hat, die ein ausgetauschtes Zertifikat nicht mitbekommen — etwa alte Backup-Agenten mit hartcodiertem Fingerprint — der muss die Erneuerung mit einem geplanten Client-Rollout koppeln. In solchen Fällen lohnt sich die Diskussion, ob der Client auf eine moderne CA-basierte Trust-Logik umgestellt werden kann; CA-Pinning auf 90-Tage-Zertifikate ist in der Praxis nicht haltbar.
Mehr zu diesen Themen:
Weitere Artikel
TrueNAS für Architekturbüros: CAD-, Rendering- und Projekt-Storage ohne SMB-Stottern
Praxisleitfaden für CAD-Storage im Architekturbüro: TrueNAS mit SMB-Multichannel, 10 GbE, Snapshots pro Meilenstein. Autodesk-tauglich, ehrlich dimensioniert.
TrueNAS Performance messen mit fio und iozone: Methodik, Fallstricke und wie man ehrliche Zahlen bekommt
TrueNAS Performance messen in der Praxis: wie fio und iozone sinnvoll aufgesetzt werden, warum der ARC-Cache fast jedes Ergebnis verfälscht und was Benchmarks aussagen und was nicht.
DSGVO Art. 9 in der Arztpraxis: wie TrueNAS die besonderen Kategorien personenbezogener Daten absichert
DSGVO Art. 9 in der Arztpraxis konkret: Gesundheitsdaten mit TrueNAS verschlüsselt, protokolliert und revisionssicher ablegen. Mit § 630f BGB und Löschkonzept.