DDM HilfeÜberblick
Mit einem Enterprise-Vertrag können Sie DDM auf Ihren eigenen Servern betreiben, statt es bei uns zu nutzen. Ihre Dokumente, Ihre Datenbank und Ihre Anmeldungen bleiben dann ganz bei Ihnen. Diese Seiten beschreiben, wie Sie eine solche Installation einrichten, aktualisieren und sichern.
Was zu einer Installation gehört
Eine Installation besteht aus vier Diensten, jeder in einem eigenen Container:
| Dienst | Aufgabe |
|---|---|
| cms | Das CMS zum Verwalten, die Schnittstellen für alle anderen Dienste und Systeme, die Anmeldung. Spielt beim Start neue Datenbank-Migrationen ein. |
| client | Die Leser-App im Browser und das Ziel der Mobil- und Desktop-App. |
| render-worker | Liest den Text hochgeladener Dokumente, erzeugt Vorschaubilder und wandelt Office-Dateien in PDF um. |
| postgres | Die Datenbank, mit dem deutschen Wörterbuch, mit dem DDM sucht. |
CMS und Leser-App laufen unter zwei Hostnamen, zum Beispiel cms.firma.de und app.firma.de, jeweils mit eigenem TLS-Zertifikat. Die Dokumente liegen auf einem Volume oder in einem S3-kompatiblen Bucket (MinIO, Ceph oder der Bucket eines Cloud-Anbieters).
Was Sie von uns bekommen
- Ein Deploy-Token für unsere Container-Registry. Damit laden Ihre Server die Images:
registry.gitlab.com/iq-me/new-ddm-images/cms,client,render-workerundpostgres. - Eine Lizenz – ein Text, der mit
ddm1.beginnt. Sie nennt Ihren Tarif und wie viele Plätze und Organisationen die Installation haben darf.
Wie die Installation mit uns verbunden bleibt
Die Installation meldet sich einmal am Tag bei uns, um ihre Lizenz zu erneuern. Dabei sendet sie nur Zahlen: wie viele Plätze und Organisationen sie nutzt und welche Version sie hat – keine Namen, keine Dokumente. Mit der Antwort erfährt sie, ob es eine neue Version gibt.
Außerdem gehen Wünsche und Fehlermeldungen, die jemand in Ihrer Installation abschickt, direkt an das DDM-Team. Das Gespräch darüber führen Sie wie gewohnt unter Meine Meldungen.
Darf Ihr Server nicht ins Internet, erneuern Sie die Lizenz von Hand – siehe Lizenz.
Was Sie brauchen
- Einen Linux-Server mit Docker Engine 25 oder neuer und Docker Compose v2 – oder einen Kubernetes-Cluster ab Version 1.27.
- Mindestens 4 Kerne und 8 GB Arbeitsspeicher. Den größten Teil braucht der Render-Worker: LibreOffice nimmt etwa 0,5 GB je Dokument, das gleichzeitig umgewandelt wird, für eine sehr große Datei mehrere GB.
- Speicherplatz für Ihre Dokumente und ihre Vorschauen, dazu drei Sicherungen der Datenbank.
- Zwei DNS-Namen, die auf den Server zeigen, und TLS-Zertifikate dafür. Mit dem mitgelieferten Caddy holt der Server sie sich selbst bei Let's Encrypt.
- Einen Mailserver, über den DDM Einladungen, Passwort-Links und Benachrichtigungen verschickt.
- Ausgehend HTTPS zu
registry.gitlab.com(Images) undcms.documentdistributionmanager.com(Lizenz, Updates, Wünsche) – über einen Proxy, wenn nötig. Alle Freigaben stehen unter Firewall.
Wer die Installation betreut
Eine Installation hat keine Betreiber von uns. Die Inhaber und Administratoren Ihrer Organisationen betreuen sie: Sie sehen die Lizenz unter Einstellungen › Lizenz, bekommen die E-Mails, wenn sie abläuft oder eine neue Version erscheint, und können sich auch dann noch anmelden, wenn die Lizenz abgelaufen ist.
Weiter: Mit Docker Compose einrichten oder mit Kubernetes.