Für Administratoren
← Alle Themen

Installation Schritt für Schritt

Vom leeren Server bis zur ersten Anmeldung: das Paket prüfen, ./draften install, HTTPS, die Lizenz und das erste Postfach.

Die ganze Installation erledigt ein Befehl, ./draften install, ausgeführt im entpackten Paket. Hier ist der Ablauf vom leeren Server bis zur ersten Anmeldung. Was eine Installation enthält und was wo liegt, beschreibt Installation auf dem eigenen Server.

Schritt 1: Den Server vorbereiten

Für die Installation braucht der Server kein Internet: Das Paket bringt alle Images mit.

Schritt 2: Prüfen, dass das Paket von uns ist

Zu jedem Versionspaket draften-<version>.tar veröffentlichen wir seine Prüfsumme. Berechnen Sie sie und vergleichen Sie:

sha256sum draften-<version>.tar

Jede spätere Aktualisierung prüft die Installation selbst anhand unserer Schlüssel. Die erste Installation hat allerdings nichts, womit sie vergleichen könnte – das hier ist ihre Prüfung. Weichen die Prüfsummen ab, installieren Sie das Paket nicht und melden Sie sich bei uns.

Schritt 3: 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:

mkdir /srv/draften
tar -xf draften-<version>.tar -C /srv/draften
cd /srv/draften
./draften install

Das Installationsprogramm lädt die Images, prüft das Paket und fragt nach dem, was es braucht.

Schritt 4: Die Fragen des Installationsprogramms beantworten

Jede Antwort lässt sich auch direkt im Befehl angeben, sodass Sie die Installation skripten können; ./draften help listet die Optionen auf. Zum Beispiel:

./draften install --url https://draften.firma.cz --org "Firma GmbH" \
  --admin-email jan@firma.cz --admin-name "Jan Novák" --locale cs --updater yes

Schritt 5: Eine Kopie von .env außerhalb des Servers aufbewahren

Das Installationsprogramm schreibt die Einstellungen und Geheimnisse in die Datei .env im Verzeichnis der Installation. Kopieren Sie sie – mindestens den Wert MASTER_KEY – an einen sicheren Ort außerhalb des Servers. Dieser Schlüssel verschlüsselt die Zugriffe auf Postfächer, die Modellschlüssel und die Passwörter für den E-Mail-Versand. Ohne ihn kann sie niemand lesen, auch nicht aus einer Sicherung – und wir haben ihn nicht.

Schritt 6: Das Passwort festlegen und sich anmelden

Am Ende gibt das Installationsprogramm einen Link zum Festlegen des Passworts des ersten Administrators aus. Öffnen Sie ihn im Browser, legen Sie das Passwort fest, und Sie sind angemeldet. Der Link funktioniert einmal und ist 7 Tage gültig. Wie die Seite für das Passwort aussieht, zeigt die Anleitung Anmeldung.

Den Link gibt nur das Installationsprogramm aus. Kopieren Sie ihn nirgendwohin und leiten Sie ihn nicht weiter – wer ihn hat, legt das Passwort des Administrators fest.

Schritt 7: Die Adresse veröffentlichen

Je nachdem, was Sie in Schritt 4 gewählt haben:

Ein Zertifikat lässt sich auch später hinzufügen:

./draften certificate cert.pem key.pem --url https://draften.firma.cz

Schritt 8: Die Lizenz hochladen

Die Lizenz senden wir als Datei licence-<number>.json. Öffnen Sie in der Oberfläche Installation → Installation, wählen Sie die Datei unten in der Karte Lizenz 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. Mehr unter Die Lizenz.

Schritt 9: Standardschlüssel und E-Mail-Versand festlegen

Legen Sie auf derselben Seite Installation die Standard-API-Schlüssel für die Modelle und den Standard-E-Mail-Versand fest (von wo Einladungen und Passwort-Links kommen). Sie gelten für jede Organisation, die keine eigenen festlegt. Einzelheiten: API-Schlüssel für Modelle und E-Mail-Versand.

Schritt 10: Ein Postfach verbinden und einen Assistenten einrichten

Ab hier geht es weiter wie bei jeder anderen Installation:

  1. Ein Postfach hinzufügen und verbinden.
  2. Einen Assistenten in der geführten Einrichtung anlegen.
  3. Weitere Personen einladen – Personen und Rollen.

Schritt 11: Prüfen, dass alles läuft

./draften status

gibt die Version, den Zustand der Weboberfläche und der Worker, den Stand von HTTPS und die Datenbanksicherungen aus. In der Oberfläche zeigt die Seite Betrieb, ob sich die Worker melden – siehe Betrieb und Kapazität.

Weiter

Textfassung