Pro administrátory
← Na rozcestník

Instalace krok za krokem

Od prázdného serveru po první přihlášení: ověření balíčku, ./draften install, HTTPS, licence a první schránka.

Celou instalaci obstará jeden příkaz, ./draften install, spuštěný v rozbaleném balíčku. Tady je postup od prázdného serveru po první přihlášení. Co instalace obsahuje a co kde leží, popisuje Instalace na vlastní server.

Krok 1: Připravte server

Internet server k instalaci nepotřebuje: balíček přináší všechny obrazy.

Krok 2: Ověřte, že balíček je od nás

K balíčku vydání draften-<verze>.tar zveřejňujeme jeho kontrolní součet. Spočítejte ho a porovnejte:

sha256sum draften-<verze>.tar

Každou další aktualizaci si instalace ověří sama podle našich klíčů. První instalace ale nemá s čím porovnávat — tohle je její kontrola. Když se součty liší, balíček neinstalujte a ozvěte se nám.

Krok 3: Rozbalte balíček a spusťte instalátor

Zvolte adresář, kde bude instalace žít, rozbalte do něj balíček a spusťte instalátor:

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

Instalátor nahraje obrazy, zkontroluje balíček a zeptá se na to, co potřebuje.

Krok 4: Odpovězte na otázky instalátoru

Každou odpověď jde zadat i rovnou v příkazu, takže instalaci můžete naskriptovat; volby vypíše ./draften help. Například:

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

Krok 5: Uložte si kopii .env mimo server

Instalátor zapíše nastavení a tajemství do souboru .env v adresáři instalace. Zkopírujte si ho — aspoň hodnotu MASTER_KEY — na bezpečné místo mimo server. Tímhle klíčem jsou zašifrované přístupy ke schránkám, klíče k modelům a hesla k odesílání pošty. Bez něj je nepřečte nikdo, ani ze zálohy — a my ho nemáme.

Krok 6: Nastavte si heslo a přihlaste se

Na konci instalátor vypíše odkaz pro nastavení hesla prvního administrátora. Otevřete ho v prohlížeči, nastavte heslo a jste přihlášení. Odkaz jde použít jednou a platí 7 dní. Jak vypadá stránka nastavení hesla, ukazuje návod Přihlášení.

Odkaz vypíše jen instalátor. Nikam ho nekopírujte a nepřeposílejte — kdo ho má, nastaví heslo administrátora.

Krok 7: Zveřejněte adresu

Podle toho, co jste zvolili v kroku 4:

Certifikát jde přidat i později:

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

Krok 8: Nahrajte licenci

Licenci posíláme jako soubor licence-<číslo>.json. V rozhraní otevřete Správa instalace → Instalace, dole v kartě Licence vyberte soubor a nahrajte ho. Dokud instalace licenci nemá, asistenti nezpracovávají poštu a nejde založit schránku ani asistenta. Víc v článku Licence.

Krok 9: Nastavte výchozí klíče a odesílání pošty

Na téže stránce Instalace nastavte výchozí API klíče k modelům a výchozí odesílání pošty (odkud chodí pozvánky a odkazy na heslo). Platí pro všechny organizace, které si nenastaví vlastní. Podrobnosti: API klíče k modelům a Odesílání pošty.

Krok 10: Připojte schránku a založte asistenta

Teď už pokračujete jako na každé jiné instalaci:

  1. Přidejte a připojte schránku.
  2. Založte asistenta průvodcem.
  3. Pozvěte další lidi — Lidé a role.

Krok 11: Ověřte, že všechno běží

./draften status

vypíše verzi, zdraví webu i workerů, stav HTTPS a výpisy databáze. V rozhraní stránka Provoz ukazuje, jestli se workery ozývají — viz Provoz a výkon.

Dál

Textová verze