DocuSeal mit Docker installieren: Du startest einen eigenen Dienst für elektronische PDF-Signaturen, speicherst seine Daten persistent und richtest eine HTTPS-Subdomain wie sign.example.com ein.
Das Ergebnis: Du kannst eine Signaturvorlage anlegen, eine Testanfrage versenden und überprüfen, dass Dokumente nach einem Containerneustart erhalten bleiben. Welche Signaturart rechtlich genügt, hängt vom Anwendungsfall ab.
Stand: 3. November 2026. Dieser Artikel ersetzt die bisherige sehr knappe Installationsnotiz. Die Docker-Grundlagen folgen der offiziellen DocuSeal-Installationsanleitung. Die zusätzliche localhost-Bindung ist eine bewusste Sicherheitsmaßnahme, falls ein Reverse Proxy auf demselben Host davorsteht.
1. Was ist DocuSeal?
DocuSeal ist eine Plattform zum Vorbereiten, Versenden und elektronischen Signieren von Dokumenten. Du kannst PDF-Vorlagen definieren, Felder für Unterschriften und Angaben ergänzen und Signaturanfragen an Personen verschicken. Im Self-Hosting-Modus liegen die Anwendungsdaten auf deinem eigenen Server, sofern du Persistenz und externe Integrationen entsprechend einrichtest.

Screenshot: DocuSeal-Dokumentationsseite zur Vorlagenverwaltung.
2. Voraussetzungen: Docker, Port und Speicher
- Linux-Server mit Docker Engine und dem Docker-Compose-Plugin (beispielsweise Ubuntu oder Debian).
- Ausreichend Festplattenspeicher für PDF-Dokumente, Datenbank und Anhänge sowie regelmäßige Backups.
- SSH-/sudo-Zugriff und eine private oder öffentliche Domain wie
sign.example.com. - Ein Reverse Proxy für HTTPS, beispielsweise Pangolin, Coolify-Traefik oder Nginx.
- Ein eigenes, nur dem Dienst zugeordnetes Persistenzverzeichnis.
DocuSeal verwendet laut offizieller Dokumentation standardmäßig SQLite; für größere oder verteilte Setups sind auch PostgreSQL und MySQL mit entsprechender DATABASE_URL möglich. Für ein kleines Homelab ist SQLite häufig ausreichend, sofern regelmäßige konsistente Backups eingerichtet werden.
3. DocuSeal als neuen Docker-Compose-Dienst anlegen
sudo mkdir -p /opt/docuseal/data
cd /opt/docuseal
sudo nano compose.yaml
Speichere folgende Compose-Datei. Damit läuft die Anwendung auf dem internen Containerport 3000, wird auf dem Host aber nur unter 127.0.0.1:3400 veröffentlicht. Dieser Port ist nicht aus dem Internet erreichbar, bis du absichtlich einen passenden sicheren Reverse Proxy konfigurierst.
services:
docuseal:
image: docuseal/docuseal:latest
container_name: docuseal
restart: unless-stopped
ports:
- "127.0.0.1:3400:3000"
volumes:
- ./data:/data
Das Volume ./data:/data speichert den wesentlichen DocuSeal-Zustand persistent. Der Originalartikel hatte -v.:/data ohne erkennbaren Leerraum; dieses Beispiel vermeidet die unklare relative Pfadangabe und verwendet ein eigenes Verzeichnis. Für reproduzierbare Updates kannst du statt latest nach Prüfung der verfügbaren Tags einen festen Image-Tag oder Digest wählen.
4. Container starten und ersten Login durchführen
cd /opt/docuseal
sudo docker compose config --quiet
sudo docker compose up -d
sudo docker compose ps
sudo docker compose logs --tail=80 docuseal
Erfolgskontrolle: docker compose ps zeigt einen laufenden DocuSeal-Container; die Logs enthalten keine wiederkehrenden Startfehler. Öffne anschließend über den im nächsten Schritt eingerichteten SSH-Tunnel die lokale Oberfläche und schließe die Ersteinrichtung ab. Lege erst danach eine Testvorlage an. Für die Datensicherheit reicht die Containeranzeige running nicht aus: Kontrolliere den Mount ./data:/data und teste deine Backups.
Öffne lokal auf dem Server die Anwendung unter http://127.0.0.1:3400. Von deinem Arbeitsplatz ist die sicherste Variante vor der öffentlichen Domain-Einrichtung eine SSH-Portweiterleitung:
ssh -L 3400:127.0.0.1:3400 BENUTZER@DEIN-SERVER
Öffne anschließend auf dem eigenen Rechner http://127.0.0.1:3400 und folge der aktuell angezeigten DocuSeal-Ersteinrichtung. Richte starke Zugangsdaten ein. Gib den ersten Administrationszugang nicht öffentlich frei, bevor er geschützt ist.
5. Eigene Domain sign.example.com mit HTTPS
Damit DocuSeal unter einer schönen Adresse erreichbar wird, richtest du beim DNS-Anbieter einen A-/AAAA-Eintrag beziehungsweise einen Cloudflare-Tunnel-Hostnamen für sign.example.com ein. Der Hostname muss zum tatsächlich vorgeschalteten Reverse Proxy führen, nicht zum internen Containerport.
Beispiel direkte DNS-Auflösung:
A sign 203.0.113.20
Reverse-Proxy Host: sign.example.com
Interne Zieladresse: http://127.0.0.1:3400
Öffentliches Protokoll: https
Die Zieladresse gilt nur, wenn Reverse Proxy und DocuSeal denselben Host-Netzwerkkontext teilen. Ein separater Pangolin-Server, anderer Docker-Container oder Coolify-Host braucht ein aus seiner eigenen Netzwerksicht erreichbares Ziel (z. B. privates Docker-Netz, interne IP oder gesicherten Site-Tunnel).
Wildcard-DNS wie *.example.com vereinfacht die Namensauflösung, legt aber keine Ressource an und stellt kein Zertifikat aus. Mehr dazu in unserer ausführlichen Wildcard-DNS-Anleitung.
6. Eine Signaturvorlage erstellen und versenden
- Im DocuSeal-Dashboard eine neue Vorlage anlegen und das gewünschte PDF hochladen.
- Felder wie Name, Datum, Kontrollkästchen und Unterschrift an die richtige Position im Dokument ziehen.
- Empfängerrollen und Pflichtfelder definieren; prüfen, welche Angaben die jeweilige Person ausfüllen soll.
- Vor dem echten Versand mit Testdaten kontrollieren, ob der Signaturablauf und die E-Mail-Benachrichtigungen funktionieren.
- Nach dem Signieren die erzeugten Dokumente, Bestätigungen und gegebenenfalls Auditinformationen gemäß deinen Datenschutzregeln sichern.
Für ausgehende Benachrichtigungen kann eine E-Mail-/SMTP-Konfiguration erforderlich sein. Prüfe die aktuell unterstützten Integrations- und E-Mail-Einstellungen in der verwendeten DocuSeal-Version. Ein selbst gehosteter Signaturdienst ist kein Ersatz für einen rechtlich geprüften Identitäts- und Signaturprozess.
7. Sicherheit, Datenschutz und Rechtslage
In Deutschland und der EU können unterschiedliche Formen elektronischer Signaturen unterschiedliche rechtliche Anforderungen erfüllen. Eine einfache elektronische Signatur ist nicht mit einer qualifizierten elektronischen Signatur (QES) gleichzusetzen. Je nach Vertragsart und gesetzlich vorgeschriebener Form reicht das bloße Einzeichnen einer Unterschrift nicht aus. Prüfe dafür die eIDAS-Anforderungen und gegebenenfalls die konkrete Formvorschrift.
- Anmeldung mit starkem Passwort und möglichst zusätzlichem MFA/SSO-Schutz absichern.
- TLS für jede öffentliche Signaturseite und den Zugriff auf vertrauliche PDFs aktivieren.
- Backups und Zugriffsrechte für
/opt/docuseal/dataeinschränken. - Personenbezogene Daten und unterschriebene Dokumente nur so lange wie erforderlich aufbewahren.
- Keine öffentlichen Dokumentfreigaben oder Testlinks dauerhaft aktiviert lassen, wenn sie nicht benötigt werden.
8. Backups und Updates
Sichere vor einem Update das gesamte Datenverzeichnis und – bei produktiver Datenbankverwendung – den konsistenten Datenbankzustand. Bei SQLite ist ein Snapshot des laufenden Verzeichnisses nicht in jeder Situation konsistent; für sichere Sicherungen muss die Datenbank korrekt gesichert oder der Dienst kontrolliert angehalten werden.
cd /opt/docuseal
sudo docker compose pull
sudo docker compose up -d
sudo docker compose ps
sudo docker compose logs --tail=100 docuseal
Teste nach dem Update zuerst das Dashboard, dann eine Testvorlage und danach den vollständigen Signaturablauf. Bei einem Produktionssystem empfiehlt sich ein Testdeployment, bevor echte Unterschriften betroffen sind.
9. Häufige Fehler
Port 3400 oder 3000 bereits belegt
Prüfe mit sudo ss -lntup, welche Prozesse Port 3400 belegen. Der Host-Port kann angepasst werden, solange du den Containerport 3000 und die Proxy-Zieladresse entsprechend berücksichtigst.
502 oder 504 beim Aufruf über die eigene Domain
Der Reverse Proxy kann die Anwendung nicht erreichen oder verwendet falsches HTTP-/HTTPS-Schema. Teste aus dem Proxy-Netzwerk, ob DocuSeal erreichbar ist. 127.0.0.1 verweist in unterschiedlichen Containern immer auf den jeweiligen Container selbst.
Nach Container-Neustart sind Daten verschwunden
Prüfe den Mount auf /data, Schreibrechte und ob du den Container mit der identischen Compose-Datei neu gestartet hast. Ein anderer Bind-Mount-Pfad führt scheinbar zu einer frischen Installation, obwohl die alten Daten noch in einem anderen Verzeichnis liegen.
E-Mail-Benachrichtigung kommt nicht an
Prüfe die in deiner Version verwendeten SMTP-Einstellungen, die Zustellbarkeit des SMTP-Servers, den Versandstatus und mögliche Spamfilter beim Empfänger.
FAQ
Kann ich DocuSeal mit Coolify installieren?
Ja, als Docker-Image oder passend zum Projekt als Compose-Service. Du musst Daten dauerhaft speichern, den richtigen Containerport 3000 setzen und die Domain über den zuständigen Reverse Proxy routen.
Reicht ein Docker-Volume für ein Backup?
Nein. Das Volume hält Daten zwischen Container-Neustarts, ersetzt aber kein separates, überprüftes Backup.

Schreiben Sie einen Kommentar