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:
- server podle Podporovaného prostředí a přístup na něj přes SSH s právy roota (nebo
sudo), - licenční soubor
licence-<číslo>.json, který od nás dostanete — je v něm i klíč ke stažení balíčku, - adresu, na které lidé draften otevřou (třeba
https://draften.firma.cz), a možnost nastavit pro ni záznam v DNS, - rozhodnutí, kde bude končit HTTPS: přímo v draftenu (potřebujete certifikát a jeho klíč ve formátu PEM), ve vaší reverzní proxy, nebo v Cloudflare Tunnelu — viz krok 7,
- API klíč k jazykovému modelu (Anthropic, OpenAI) nebo adresu vlastního OpenAI-kompatibilního serveru,
- údaje k SMTP serveru, odkud bude draften posílat pozvánky a odkazy na nastavení hesla (nebo API klíč Brevo).
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ázka | Co 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 name | název vaší organizace |
| Its short name | krátký název: malá písmena, číslice a pomlčky. Navrhne ho z názvu organizace |
| The first administrator's e-mail | e-mail prvního administrátora. Stane se vlastníkem organizace i provozovatelem celé instalace |
| Their name | jeho jméno |
| Their language | cs, en, de, fr, es, it, pt nebo pl (výchozí en) |
| Run the updater | yes 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 file | cesta 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á
- Zapíše nastavení a tajemství do souboru
.env— čitelného jen pro vlastníka. Hesla databáze, šifrovací klíčMASTER_KEYa tajemství relací vygeneruje náhodně a nikam je nevypisuje. - Založí složky
data/,backups/a první organizaci s administrátorem. - Spustí draften a ověří, že odpovídá.
- 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:
- Výchozí API klíče — klíče k modelům pro všechny organizace a schránky bez vlastních. Viz API klíče k modelům.
- Výchozí odesílání pošty — odkud chodí pozvánky a odkazy na nastavení hesla: Odesílatel (adresa), Odesílatel (jméno), SMTP server, Port (výchozí 587), Šifrování (STARTTLS na 587, TLS na 465), Uživatel a Heslo — nebo API klíč Brevo. Tlačítkem Poslat zkušební zprávu ověříte, že pošta odchází. Bez odesílatele se nikomu nepošle pozvánka ani odkaz na heslo. Viz Odesílání pošty.
Krok 11: Připojte poštu a lidi
- 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.
- Kdo se má přihlašovat účtem Microsoft nebo Google, nastavte v Přihlašování členů.
- Přidejte a připojte schránku.
- Založte asistenta průvodcem.
- 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:
- s HTTPS v draftenu porty 80 a 443,
- s reverzní proxy na jiném stroji port 8085 jen z adresy proxy,
- s Cloudflare Tunnelem ani jeden,
- SSH jen z adres, odkud server spravujete.
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
- Aktualizace přes updater — nová verze jedním tlačítkem,
- Aktualizace z příkazové řádky,
- Zálohy a obnova,
- Řešení potíží.