Der ganze Ablauf vom leeren Server bis zum abgesicherten Betrieb: Herunterladen des Pakets, Installation, HTTPS, erste Anmeldung, Einstellungen und Absicherung des Servers. Welche Anforderungen der Server erfüllen muss, steht im Artikel Unterstützte Umgebung; woraus eine Installation besteht, beschreibt Installation auf dem eigenen Server.
Bevor Sie beginnen
Bereiten Sie vor:
- einen Server gemäß der Unterstützten Umgebung und Zugang per SSH mit Root-Rechten (oder
sudo), - die Lizenzdatei
licence-<nummer>.json, die Sie von uns erhalten – sie enthält auch den Schlüssel zum Herunterladen des Pakets, - die Adresse, unter der die Leute draften öffnen (etwa
https://draften.firma.cz), und die Möglichkeit, dafür einen DNS-Eintrag anzulegen, - die Entscheidung, wo HTTPS enden soll: direkt in draften (Sie brauchen ein Zertifikat und seinen Schlüssel im PEM-Format), in Ihrem Reverse Proxy oder in einem Cloudflare Tunnel – siehe Schritt 7,
- einen API-Schlüssel für ein Sprachmodell (Anthropic, OpenAI) oder die Adresse Ihres eigenen OpenAI-kompatiblen Servers,
- die Angaben zu einem SMTP-Server, über den draften Einladungen und Links zum Festlegen des Passworts sendet (oder einen API-Schlüssel von Brevo).
Schritt 1: Den Server vorbereiten
Installieren Sie Docker Engine mit dem Compose-Plugin. Unter Ubuntu aus dem offiziellen Repository von Docker:
sudo apt-get update
sudo apt-get install -y ca-certificates curl
sudo install -m 0755 -d /etc/apt/keyrings
sudo curl -fsSL https://download.docker.com/linux/ubuntu/gpg -o /etc/apt/keyrings/docker.asc
sudo chmod a+r /etc/apt/keyrings/docker.asc
echo "deb [arch=$(dpkg --print-architecture) signed-by=/etc/apt/keyrings/docker.asc] https://download.docker.com/linux/ubuntu $(. /etc/os-release && echo "$VERSION_CODENAME") stable" | sudo tee /etc/apt/sources.list.d/docker.list > /dev/null
sudo apt-get update
sudo apt-get install -y docker-ce docker-ce-cli containerd.io docker-compose-plugin
Auf anderen Distributionen folgen Sie https://docs.docker.com/engine/install/. Das Paket docker.io aus den Repositorys der Distribution ist oft alt und hat kein Compose-Plugin.
Prüfen Sie die Versionen – Docker muss 24 oder neuer sein, und docker compose muss antworten:
docker version --format '{{.Server.Version}}'
docker compose version
Schritt 2: Das Paket herunterladen
Das Paket wird von download.draften.ai mit dem Schlüssel heruntergeladen, der in der Lizenzdatei steht. Diese Befehle ziehen den Schlüssel aus der Lizenz und listen die verfügbaren Versionen auf:
KEY=$(sed -n 's/.*"payload":"\([^"]*\)".*/\1/p' licence-<nummer>.json | tr '_-' '/+' | awk '{ while (length($0) % 4) $0 = $0 "="; print }' | base64 -d | sed -n 's/.*"key": *"\([^"]*\)".*/\1/p')
curl -fsS -H "Authorization: Bearer $KEY" https://download.draften.ai/v1/latest.json | sed -n 's/.*"payload":"\([^"]*\)".*/\1/p' | tr '_-' '/+' | awk '{ while (length($0) % 4) $0 = $0 "="; print }' | base64 -d
Die Liste zeigt die Versionen der letzten sechs Monate – bei jeder die Version, das Datum, die Notizen, die Größe und die Prüfsumme sha256 – und unter latest die neueste, die nicht zurückgezogen wurde. Laden Sie diese Version herunter:
curl -fS -H "Authorization: Bearer $KEY" -o draften-<version>.tar https://download.draften.ai/v1/bundles/draften-<version>.tar
Das Paket ist etwa 500 MB groß. Antwortet der Server mit dem Fehler 403, ist die Lizenz unbekannt, widerrufen oder abgelaufen – die Meldung sagt, warum.
Server ohne Internet: Laden Sie das Paket mit denselben Befehlen auf einem anderen Rechner herunter und übertragen Sie es auf den Server (etwa mit scp). Die Prüfsumme können wir Ihnen in diesem Fall zusammen mit dem Paket schicken.
Schritt 3: Das Paket prüfen
Berechnen Sie die Prüfsumme und vergleichen Sie sie mit dem Wert sha256 bei dieser Version in der Liste aus Schritt 2:
sha256sum draften-<version>.tar
Weichen die Prüfsummen ab, installieren Sie das Paket nicht und melden Sie sich bei uns. Das ist die einzige Prüfung von Hand: Jede weitere Aktualisierung prüft die Installation selbst anhand unserer Schlüssel.
Schritt 4: Das Paket entpacken und das Installationsprogramm starten
Wählen Sie das Verzeichnis, in dem die Installation liegen soll, entpacken Sie das Paket dorthin und starten Sie das Installationsprogramm:
sudo mkdir /srv/draften
sudo tar -xf draften-<version>.tar -C /srv/draften
cd /srv/draften
sudo ./draften install
Das Installationsprogramm lädt zuerst die Images (eine oder zwei Minuten) und prüft die Signatur und den Inhalt des Pakets. Schlägt die Prüfung fehl („this bundle does not check out“), ist das Paket beschädigt – laden Sie es erneut herunter.
Schritt 5: Die Fragen des Installationsprogramms beantworten
Das Installationsprogramm fragt auf Englisch:
| Frage | Was Sie eingeben |
|---|---|
| Where will people open draften (the full address) | die Adresse mit https://, etwa https://draften.firma.cz. Es muss die Adresse sein, die die Leute wirklich verwenden – aus ihr entstehen auch die Weiterleitungsadressen der Anmeldung mit Microsoft und Google |
| The organisation's name | der Name Ihrer Organisation |
| Its short name | ein Kurzname: Kleinbuchstaben, Ziffern und Bindestriche. Das Programm schlägt ihn aus dem Namen der Organisation vor |
| The first administrator's e-mail | die E-Mail-Adresse des ersten Administrators. Er wird Inhaber der Organisation und Betreiber der ganzen Installation |
| Their name | sein Name |
| Their language | cs, en, de, fr, es, it, pt oder pl (Standard en) |
| Run the updater | yes oder no (Standard yes). Mit dem Updater können Sie über die Weboberfläche aktualisieren, die Zahl der Prozesse ändern, den Verschlüsselungsschlüssel ersetzen und Sicherungen anlegen. Er hat Zugriff auf Docker, also Root-Rechte auf dem Server. Ohne ihn geht alles über die Kommandozeile |
| HTTPS certificate file (PEM) | der Pfad zum Zertifikat, wenn HTTPS direkt in draften enden soll; sonst leer lassen |
| Its private key file | der Pfad zum Schlüssel des Zertifikats |
Mit einem Zertifikat muss die Adresse mit https:// beginnen. Jede Antwort lässt sich auch direkt im Befehl angeben, sodass Sie die Installation skripten können; die Optionen listet ./draften help auf:
sudo ./draften install --url https://draften.firma.cz --org "Firma GmbH" \
--admin-email jan@firma.cz --admin-name "Jan Novák" --locale en --updater yes
Schritt 6: Was das Installationsprogramm tut
- Es schreibt die Einstellungen und Geheimnisse in die Datei
.env– nur für ihren Eigentümer lesbar. Die Passwörter der Datenbank, den VerschlüsselungsschlüsselMASTER_KEYund die Geheimnisse der Sitzungen erzeugt es zufällig und gibt sie nirgends aus. - Es legt die Ordner
data/,backups/und die erste Organisation mit dem Administrator an. - Es startet draften und prüft, dass es antwortet.
- Am Ende gibt es die Adresse und den Link zum Festlegen des Passworts des ersten Administrators aus und erinnert daran, eine Kopie von
.envaufzubewahren.
Schlägt der erste Start fehl („the first start failed“), sehen Sie sich docker compose ps und docker compose logs an. Gibt es den Link nicht aus, finden Sie ihn mit docker compose logs worker | grep set-password – der Worker gibt ihn bei jedem Start aus, solange kein Passwort existiert.
Bewahren Sie sofort eine Kopie von .env außerhalb des Servers auf – mindestens den Wert MASTER_KEY. Mit diesem Schlüssel sind die Zugriffe auf Postfächer, die Modellschlüssel und die Passwörter für den E-Mail-Versand verschlüsselt. Ohne ihn kann sie niemand lesen, auch nicht aus einer Sicherung – und wir haben ihn nicht.
Schritt 7: draften über HTTPS veröffentlichen
Wählen Sie je nachdem, wo HTTPS endet, eine Variante. Richten Sie den DNS-Eintrag Ihrer Adresse auf den Server (oder auf den Proxy).
HTTPS direkt in draften
Haben Sie dem Installationsprogramm ein Zertifikat gegeben, lauscht draften auf Port 443 und leitet von Port 80 auf HTTPS um. Es genügen DNS und die offenen Ports 80 und 443. Ein Zertifikat lässt sich auch später hinzufügen, und mit demselben Befehl ersetzen Sie es nach einer Erneuerung, ohne eine einzige Anfrage zu verlieren:
sudo ./draften certificate cert.pem key.pem --url https://draften.firma.cz
Um die Erneuerung des Zertifikats (etwa mit einem ACME-Client) kümmern Sie sich selbst; führen Sie nach jeder Erneuerung diesen Befehl aus.
Ihr Reverse Proxy
Ohne Zertifikat lauscht draften nur auf 127.0.0.1:8085. Ein Proxy auf demselben Rechner leitet die Anfragen an diese Adresse weiter und übergibt die Header Host und X-Forwarded-Proto. Zum Beispiel für Caddy (das Zertifikat besorgt es sich selbst):
draften.firma.cz {
reverse_proxy 127.0.0.1:8085
}
oder für nginx:
server {
listen 443 ssl;
server_name draften.firma.cz;
ssl_certificate /etc/ssl/draften/fullchain.pem;
ssl_certificate_key /etc/ssl/draften/privkey.pem;
location / {
proxy_pass http://127.0.0.1:8085;
proxy_set_header Host $host;
proxy_set_header X-Forwarded-Proto https;
proxy_set_header X-Forwarded-For $proxy_add_x_forwarded_for;
}
}
Läuft der Proxy auf einem anderen Rechner, setzen Sie in .env WEB_BIND=0.0.0.0:8085, führen Sie sudo docker compose up -d aus und machen Sie Port 8085 nur für den Proxy zugänglich (siehe Schritt 13).
Cloudflare Tunnel
Braucht keinen offenen Port. Legen Sie in Cloudflare Zero Trust einen Tunnel an und kopieren Sie sein Token. Tragen Sie in .env CLOUDFLARE_TUNNEL_TOKEN=<token> ein, ergänzen Sie tunnel in COMPOSE_PROFILES (etwa COMPOSE_PROFILES=updater,tunnel) und führen Sie aus:
sudo docker compose up -d
Fügen Sie dann in Cloudflare beim Tunnel eine öffentliche Adresse (Public hostname) hinzu, die auf http://127.0.0.1:8085 zeigt. Lassen Sie WEB_BIND auf 127.0.0.1:8085. Das Image cloudflared lädt Docker von Docker Hub herunter – im Paket ist es nicht.
Schritt 8: Das Passwort festlegen und sich anmelden
Öffnen Sie den Link, den das Installationsprogramm ausgegeben hat, legen Sie das Passwort fest, und Sie sind angemeldet. Der Link funktioniert einmal und ist 7 Tage gültig. Wie die Seite zum Festlegen des Passworts aussieht, zeigt die Anleitung Anmeldung.
Kopieren Sie den Link nirgendwohin und leiten Sie ihn nicht weiter – wer ihn hat, legt das Passwort des Administrators fest.
Schritt 9: Die Lizenz hochladen
Öffnen Sie in der Oberfläche Installation → Installation, wählen Sie unten in der Karte Lizenz die Datei und laden Sie sie hoch. Solange die Installation keine Lizenz hat, verarbeiten die Assistenten keine Post, und es lassen sich weder Postfächer noch Assistenten anlegen. Mit der Lizenz achtet der Updater selbst auf neue Versionen. Mehr im Artikel Die Lizenz.
Schritt 10: Standardschlüssel und E-Mail-Versand festlegen
Auf derselben Seite Installation:
- Standard-API-Schlüssel – Schlüssel für die Modelle für alle Organisationen und Postfächer ohne eigene. Siehe API-Schlüssel für Modelle.
- Standard-E-Mail-Versand – von wo Einladungen und Links zum Festlegen des Passworts kommen: Absender (Adresse), Absender (Name), SMTP-Server, Port (Standard 587), Verschlüsselung (STARTTLS auf 587, TLS auf 465), Benutzer und Passwort – oder ein API-Schlüssel von Brevo. Mit der Schaltfläche Testnachricht senden prüfen Sie, dass die Post hinausgeht. Ohne Absender wird niemandem eine Einladung oder ein Passwort-Link geschickt. Siehe E-Mail-Versand.
Schritt 11: Post und Personen verbinden
- Entscheiden Sie, wie der Assistent an die Post kommt, und bereiten Sie das bei Microsoft oder Google vor: Microsoft 365, Google Workspace, ein anderes Postfach über IMAP.
- Wer sich mit einem Microsoft- oder Google-Konto anmelden soll, legen Sie unter Wie sich Mitglieder anmelden fest.
- Fügen Sie ein Postfach hinzu und verbinden Sie es.
- Legen Sie einen Assistenten in der geführten Einrichtung an.
- Laden Sie weitere Personen ein – Personen und Rollen.
Schritt 12: Prüfen, dass alles läuft
sudo ./draften status
gibt die Version, den Zustand der Weboberfläche und der Worker, den Stand von HTTPS und der Sicherungen aus. In der Oberfläche zeigt die Seite Betrieb, ob sich die Worker melden – siehe Betrieb und Kapazität. Wenn etwas nicht geht, hilft Fehlerbehebung; eine Datei für unseren Support erzeugt sudo ./draften diagnose.
Schritt 13: Den Server absichern
Wer Zugang zum Server hat, hat Zugang zu allem: zur Post in den Nachrichten, zu .env mit dem Schlüssel und zu den Sicherungen. Schützen Sie den Server daher wie einen Mailserver.
Firewall. Lassen Sie von außen nur durch, was nötig ist:
- mit HTTPS in draften die Ports 80 und 443,
- mit einem Reverse Proxy auf einem anderen Rechner den Port 8085 nur von der Adresse des Proxys,
- mit einem Cloudflare Tunnel keinen,
- SSH nur von den Adressen, von denen aus Sie den Server verwalten.
Docker umgeht die Regeln von UFW (und firewalld) bei den Ports, die es veröffentlicht. ufw deny 8085 schließt einen Port nicht, den Docker auf 0.0.0.0 geöffnet hat. Lassen Sie WEB_BIND daher auf 127.0.0.1:8085, wo es geht; wenn nicht, beschränken Sie den Zugang mit einer Firewall vor dem Server oder mit Regeln in der Kette DOCKER-USER.
Ausgehende Verbindungen genügt es zu den Adressen aus der Unterstützten Umgebung zu erlauben.
SSH. Anmeldung nur mit Schlüssel (PasswordAuthentication no), keine direkte Anmeldung als root (PermitRootLogin no), Administratoren mit eigenen Konten und sudo.
Wer an Docker darf. Mitgliedschaft in der Gruppe docker bedeutet Root-Rechte. Geben Sie sie nur den Administratoren des Servers.
Systemaktualisierungen. Schalten Sie automatische Sicherheitsupdates ein (unter Ubuntu unattended-upgrades) und aktualisieren Sie Docker zusammen mit dem System. Die Aktualisierungen von draften übernimmt der Updater – siehe Aktualisieren mit dem Updater.
Updater. Er hat Zugriff auf Docker, also Root-Rechte. Wenn Sie ihn nicht brauchen, schalten Sie ihn aus: Entfernen Sie in .env updater aus COMPOSE_PROFILES und führen Sie im Verzeichnis der Installation sudo docker compose rm -sf updater aus. Aktualisierungen und Sicherungen erledigen Sie dann über die Kommandozeile.
Dateien der Installation. .env ist nur für den Eigentümer lesbar, der Ordner backups/ ebenso – lassen Sie das so. Geben Sie das Verzeichnis der Installation nicht frei.
Sicherungen außerhalb des Servers. draften sichert die Datenbank jeden Tag in backups/ auf derselben Platte. Richten Sie das Kopieren von backups/ und .env an einen anderen Ort ein, verschlüsselt – die Sicherungen enthalten Post. Einzelheiten: Sicherung und Wiederherstellung.
Verschlüsselungsschlüssel. Verlässt jemand das Unternehmen, der .env kannte, ersetzen Sie MASTER_KEY (sudo ./draften rotate-key oder unter Installation) und bewahren Sie die neue Kopie von .env außerhalb des Servers auf.
Weiter
- Aktualisieren mit dem Updater – eine neue Version mit einer Schaltfläche,
- Aktualisieren über die Kommandozeile,
- Sicherung und Wiederherstellung,
- Fehlerbehebung.