Schnellstart
Doconform in zehn Minuten testen.
Eine Testinstanz auf einem Linux-Host mit Docker Compose: ohne Datenbank, ohne TLS, nur für den ersten Eindruck. Für den Dauerbetrieb gilt das Betriebshandbuch.
Nach dem Betriebshandbuch 1.8.0
Was Sie brauchen
- Linux-Host (amd64) mit mindestens 4 CPU und 12 GB RAM, Docker Engine ab 25 und Docker Compose ab 2.20.
- Die Compose-Dateien aus dem Offline-Bundle. Das Betriebshandbuch steht nach der Anmeldung im Kundenportal unter Software.
- Den Zugang zu unserer Registry oder das Offline-Bundle. Beides bekommen Sie zusammen mit der Testlizenz.
- Optional eine Lizenzdatei. Die Testlizenz für 60 Tage holen Sie im Kundenportal; ohne Lizenz läuft Doconform im Evaluationsmodus.
Images bereitstellen
docker version --format '{{.Server.Version}}' # mindestens 25
docker compose version # mindestens 2.20
# aus der Registry (Passwort aus dem Kundenportal in passwort.txt, nie auf der Kommandozeile)
docker login <registry-host> --username <benutzername> --password-stdin < passwort.txt
docker compose pull
# oder offline aus dem Bundle
for image in ../images/*.tar; do docker load -i "$image"; doneEinstellungen und Secrets
Der API-Key bleibt beim aufrufenden Client; Doconform speichert nur seinen Hash.
cp .env.example .env # Test ohne TLS: sonst scheitert die Anmeldung an der Konsole echo 'PDFA_CONSOLE_SECURECOOKIE=false' >> .env mkdir -p secrets/config && chmod 0700 secrets && chmod 0755 secrets/config # API-Key: den Klartext bekommt nur der aufrufende Client, der Dienst kennt nur den Hash KEY=$(openssl rand -base64 32); echo "Key fuer den Client: $KEY" printf 'archiv=sha256:%s\n' "$(printf %s "$KEY" | sha256sum | cut -d' ' -f1)" > secrets/api-keys # Passwort des Konsolen-Administrators "admin" openssl rand -base64 18 | tee secrets/config/pdfa.console.admin.password # Lizenz (optional) cp /pfad/zur/lizenz.json secrets/config/pdfa.license.text chmod 0644 secrets/api-keys secrets/config/*
Starten
Der Befehl kehrt zurück, wenn alle Dienste bereit sind. Der erste Start dauert etwa eine Minute.
docker compose up -d --wait docker compose ps
Erste Konvertierung
Das Ergebnis ist ein validiertes PDF/A. Die erreichte Stufe steht im Antwort-Header X-Pdfa-Level. Die Konsole unter http://127.0.0.1:8080/ zeigt den Lizenzstatus und konvertiert Dateien zur Probe.
curl -H @<(printf 'Authorization: Bearer %s\n' "$KEY") -F file=@brief.docx -o brief.pdf \ http://127.0.0.1:8080/api/v1/convert
Nächste Schritte
Für den Betrieb gehören ein TLS-Terminator, eine Datenbank, Virenscan, Sicherung und Updates dazu. Das Betriebshandbuch steht nach der Anmeldung im Kundenportal; Betrieb und Sicherheit im Überblick stehen unter Betrieb & Sicherheit.
60 Tage kostenlos testen