Pro administrátory
← Na rozcestník

Instalace krok za krokem

Úplný průvodce: stažení a ověření balíčku, ./draften install, HTTPS, licence, pošta a zabezpečení serveru.

Celý postup od prázdného serveru po zabezpečený provoz: stažení balíčku, instalace, HTTPS, první přihlášení, nastavení a zabezpečení serveru. Co server musí splňovat, je v článku Podporované prostředí; z čeho se instalace skládá, popisuje Instalace na vlastní server.

Než začnete

Připravte si:

Krok 1: Připravte server

Nainstalujte Docker Engine s pluginem compose. Na Ubuntu z oficiálního repozitáře Dockeru:

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

Na jiných distribucích postupujte podle https://docs.docker.com/engine/install/. Balíček docker.io z repozitářů distribuce bývá starý a nemá plugin compose.

Ověřte verze — Docker musí být 24 nebo novější a docker compose musí odpovědět:

docker version --format '{{.Server.Version}}'
docker compose version

Krok 2: Stáhněte balíček

Balíček se stahuje z download.draften.ai s klíčem, který je uvnitř licenčního souboru. Tyhle příkazy klíč z licence vytáhnou a vypíšou dostupná vydání:

KEY=$(sed -n 's/.*"payload":"\([^"]*\)".*/\1/p' licence-<číslo>.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

Výpis ukáže vydání za posledních šest měsíců — u každého verzi, datum, poznámky, velikost a kontrolní součet sha256 — a pod latest nejnovější, které nebylo stažené z oběhu. Tu verzi stáhněte:

curl -fS -H "Authorization: Bearer $KEY" -o draften-<verze>.tar https://download.draften.ai/v1/bundles/draften-<verze>.tar

Balíček má asi 500 MB. Když brána odpoví chybou 403, je licence neznámá, odvolaná nebo prošlá — hláška řekne proč.

Server bez internetu: stáhněte balíček na jiném stroji stejnými příkazy a přeneste ho na server (třeba scp). Kontrolní součet vám v tom případě můžeme poslat i s balíčkem.

Krok 3: Ověřte balíček

Spočítejte kontrolní součet a porovnejte ho s hodnotou sha256 u té verze ve výpisu z kroku 2:

sha256sum draften-<verze>.tar

Když se součty liší, balíček neinstalujte a ozvěte se nám. Tohle je jediná ruční kontrola: každou další aktualizaci si instalace ověří sama podle našich klíčů.

Krok 4: 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:

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

Instalátor nejdřív nahraje obrazy (minutu nebo dvě) a ověří podpis a obsah balíčku. Když ověření selže („this bundle does not check out“), balíček je poškozený — stáhněte ho znovu.

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

Instalátor se ptá anglicky:

OtázkaCo zadat
Where will people open draften (the full address)adresa včetně https://, třeba https://draften.firma.cz. Musí to být adresa, kterou lidé opravdu používají — skládají se z ní i návratové adresy přihlášení přes Microsoft a Google
The organisation's namenázev vaší organizace
Its short namekrátký název: malá písmena, číslice a pomlčky. Navrhne ho z názvu organizace
The first administrator's e-maile-mail prvního administrátora. Stane se vlastníkem organizace i provozovatelem celé instalace
Their namejeho jméno
Their languagecs, en, de, fr, es, it, pt nebo pl (výchozí en)
Run the updateryes nebo no (výchozí yes). Updater umožní aktualizovat, měnit počet procesů, měnit šifrovací klíč a zálohovat z webového rozhraní. Má přístup k Dockeru, tedy práva roota na serveru. Bez něj všechno jde z příkazové řádky
HTTPS certificate file (PEM)cesta k certifikátu, má-li HTTPS končit přímo v draftenu; jinak nechte prázdné
Its private key filecesta ke klíči certifikátu

S certifikátem musí adresa začínat https://. Každou odpověď jde zadat i rovnou v příkazu, takže instalaci můžete naskriptovat; volby vypíše ./draften help:

sudo ./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 6: Co instalátor udělá

  1. Zapíše nastavení a tajemství do souboru .env — čitelného jen pro vlastníka. Hesla databáze, šifrovací klíč MASTER_KEY a tajemství relací vygeneruje náhodně a nikam je nevypisuje.
  2. Založí složky data/, backups/ a první organizaci s administrátorem.
  3. Spustí draften a ověří, že odpovídá.
  4. Na konci vypíše adresu a odkaz pro nastavení hesla prvního administrátora, a připomene uložit si kopii .env.

Když první start selže („the first start failed“), podívejte se na docker compose ps a docker compose logs. Když odkaz nevypíše, najdete ho příkazem docker compose logs worker | grep set-password — worker ho vypisuje při každém startu, dokud heslo neexistuje.

Uložte si hned kopii .env mimo server — aspoň hodnotu MASTER_KEY. 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 7: Zveřejněte draften přes HTTPS

Podle toho, kde končí HTTPS, zvolte jednu variantu. Záznam v DNS pro vaši adresu nasměrujte na server (nebo na proxy).

HTTPS přímo v draftenu

Když jste instalátoru dali certifikát, draften poslouchá na portu 443 a z portu 80 přesměrovává na HTTPS. Stačí DNS a otevřené porty 80 a 443. Certifikát jde přidat i později a stejným příkazem ho po obnovení vyměníte bez ztráty jediného požadavku:

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

Obnovu certifikátu (třeba klientem ACME) si obstaráváte sami; po každé obnově spusťte tenhle příkaz.

Vaše reverzní proxy

Bez certifikátu draften poslouchá jen na 127.0.0.1:8085. Proxy na stejném stroji na tuto adresu posílá požadavky a předává hlavičky Host a X-Forwarded-Proto. Například pro Caddy (certifikát si obstará sám):

draften.firma.cz {
    reverse_proxy 127.0.0.1:8085
}

nebo pro 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;
    }
}

Když proxy běží na jiném stroji, nastavte v .env WEB_BIND=0.0.0.0:8085, spusťte sudo docker compose up -d a port 8085 zpřístupněte jen proxy (viz krok 13).

Cloudflare Tunnel

Nepotřebuje žádný otevřený port. V Cloudflare Zero Trust založte tunel a zkopírujte jeho token. Do .env vložte CLOUDFLARE_TUNNEL_TOKEN=<token>, do COMPOSE_PROFILES doplňte tunnel (třeba COMPOSE_PROFILES=updater,tunnel) a spusťte:

sudo docker compose up -d

V Cloudflare pak u tunelu přidejte veřejnou adresu (Public hostname) vedoucí na http://127.0.0.1:8085. WEB_BIND nechte na 127.0.0.1:8085. Obraz cloudflared si Docker stáhne z Docker Hubu — v balíčku není.

Krok 8: Nastavte si heslo a přihlaste se

Otevřete odkaz, který instalátor vypsal, 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 nikam nekopírujte a nepřeposílejte — kdo ho má, nastaví heslo administrátora.

Krok 9: Nahrajte licenci

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. S licencí si updater sám hlídá nová vydání. Víc v článku Licence.

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

Na téže stránce Instalace:

Krok 11: Připojte poštu a lidi

  1. Rozhodněte, jak se asistent dostane k poště, a připravte to u Microsoftu nebo Googlu: Microsoft 365, Google Workspace, jiná schránka přes IMAP.
  2. Kdo se má přihlašovat účtem Microsoft nebo Google, nastavte v Přihlašování členů.
  3. Přidejte a připojte schránku.
  4. Založte asistenta průvodcem.
  5. Pozvěte další lidi — Lidé a role.

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

sudo ./draften status

vypíše verzi, zdraví webu i workerů, stav HTTPS a zálohy. V rozhraní stránka Provoz ukazuje, jestli se workery ozývají — viz Provoz a výkon. Když něco nejde, pomůže Řešení potíží; soubor pro naši podporu vytvoří sudo ./draften diagnose.

Krok 13: Zabezpečte server

Kdo má přístup na server, má přístup ke všemu: k poště ve zprávách, k .env s klíčem i k zálohám. Server proto chraňte jako poštovní server.

Firewall. Zvenku pusťte jen to, co je potřeba:

Docker obchází pravidla UFW (a firewalld) u portů, které publikuje. ufw deny 8085 port, který Docker otevřel na 0.0.0.0, nezavře. Nechte proto WEB_BIND na 127.0.0.1:8085, kde to jde; když ne, omezte přístup firewallem před serverem nebo pravidly v řetězci DOCKER-USER.

Odchozí spojení stačí povolit na adresy z Podporovaného prostředí.

SSH. Přihlašování jen klíčem (PasswordAuthentication no), bez přímého přihlášení roota (PermitRootLogin no), správci s vlastními účty a sudo.

Kdo smí na Docker. Členství ve skupině docker znamená práva roota. Dávejte ho jen správcům serveru.

Aktualizace systému. Zapněte automatické bezpečnostní aktualizace (na Ubuntu unattended-upgrades) a Docker aktualizujte spolu se systémem. Aktualizace draftenu obstará updater — viz Aktualizace přes updater.

Updater. Má přístup k Dockeru, tedy práva roota. Když ho nepotřebujete, vypněte ho: v .env odeberte updater z COMPOSE_PROFILES a v adresáři instalace spusťte sudo docker compose rm -sf updater. Aktualizace a zálohy pak děláte z příkazové řádky.

Soubory instalace. .env je čitelný jen pro vlastníka a složka backups/ taky — nechte to tak. Adresář instalace nesdílejte.

Zálohy mimo server. draften zálohuje databázi každý den do backups/ na stejném disku. Nastavte kopírování backups/ a .env jinam, šifrovaně — výpisy obsahují poštu. Podrobnosti: Zálohy a obnova.

Šifrovací klíč. Když odejde někdo, kdo znal .env, vyměňte MASTER_KEY (sudo ./draften rotate-key, nebo ve Správě instalace) a novou kopii .env uložte mimo server.

Dál

Textová verze