Całe postępowanie od pustego serwera do zabezpieczonej pracy: pobranie paczki, instalacja, HTTPS, pierwsze logowanie, ustawienia i zabezpieczenie serwera. Jakie wymagania musi spełniać serwer, opisuje strona Obsługiwane środowisko; z czego składa się instalacja, opisuje strona Instalacja na własnym serwerze.
Zanim zaczniesz
Przygotuj:
- serwer zgodny z Obsługiwanym środowiskiem i dostęp do niego przez SSH z prawami roota (albo
sudo), - plik licencji
licence-<numer>.json, który dostaniesz od nas – jest w nim też klucz do pobrania paczki, - adres, pod którym ludzie będą otwierać draften (na przykład
https://draften.firma.cz), i możliwość ustawienia dla niego rekordu DNS, - decyzję, gdzie będzie się kończyć HTTPS: bezpośrednio w draften (potrzebujesz certyfikatu i jego klucza w formacie PEM), w twoim reverse proxy albo w Cloudflare Tunnel – zobacz krok 7,
- klucz API do modelu językowego (Anthropic, OpenAI) albo adres własnego serwera zgodnego z OpenAI,
- dane serwera SMTP, z którego draften będzie wysyłać zaproszenia i linki do ustawienia hasła (albo klucz API Brevo).
Krok 1: Przygotuj serwer
Zainstaluj Docker Engine z wtyczką compose. Na Ubuntu z oficjalnego repozytorium Dockera:
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 innych dystrybucjach postępuj według https://docs.docker.com/engine/install/. Pakiet docker.io z repozytoriów dystrybucji bywa stary i nie ma wtyczki compose.
Sprawdź wersje – Docker musi być w wersji 24 lub nowszej, a docker compose musi odpowiedzieć:
docker version --format '{{.Server.Version}}'
docker compose version
Krok 2: Pobierz paczkę
Paczkę pobiera się z download.draften.ai kluczem, który jest w pliku licencji. Te polecenia wyciągają klucz z licencji i wypisują dostępne wydania:
KEY=$(sed -n 's/.*"payload":"\([^"]*\)".*/\1/p' licence-<numer>.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
Wynik pokazuje wydania z ostatnich sześciu miesięcy – przy każdym wersję, datę, informacje o wydaniu, rozmiar i sumę kontrolną sha256 – a pod latest najnowsze, które nie zostało wycofane. Pobierz tę wersję:
curl -fS -H "Authorization: Bearer $KEY" -o draften-<wersja>.tar https://download.draften.ai/v1/bundles/draften-<wersja>.tar
Paczka ma około 500 MB. Gdy brama odpowie błędem 403, licencja jest nieznana, unieważniona albo wygasła – komunikat powie dlaczego.
Serwer bez internetu: pobierz paczkę na innej maszynie tymi samymi poleceniami i przenieś ją na serwer (na przykład scp). Sumę kontrolną możemy ci w takim przypadku wysłać razem z paczką.
Krok 3: Sprawdź paczkę
Oblicz sumę kontrolną i porównaj ją z wartością sha256 tej wersji w wyniku z kroku 2:
sha256sum draften-<wersja>.tar
Jeśli sumy się różnią, nie instaluj paczki i skontaktuj się z nami. To jedyne ręczne sprawdzenie: każdą kolejną aktualizację instalacja sprawdza sama względem naszych kluczy.
Krok 4: Rozpakuj paczkę i uruchom instalator
Wybierz katalog, w którym będzie instalacja, rozpakuj do niego paczkę i uruchom instalator:
sudo mkdir /srv/draften
sudo tar -xf draften-<wersja>.tar -C /srv/draften
cd /srv/draften
sudo ./draften install
Instalator najpierw wczyta obrazy (minutę lub dwie) i sprawdzi podpis i zawartość paczki. Gdy sprawdzenie się nie powiedzie („this bundle does not check out”), paczka jest uszkodzona – pobierz ją ponownie.
Krok 5: Odpowiedz na pytania instalatora
Instalator pyta po angielsku:
| Pytanie | Co wpisać |
|---|---|
| Where will people open draften (the full address) | adres łącznie z https://, na przykład https://draften.firma.cz. Musi to być adres, którego ludzie naprawdę używają – na jego podstawie powstają też adresy powrotu przy logowaniu przez Microsoft i Google |
| The organisation's name | nazwa twojej organizacji |
| Its short name | krótka nazwa: małe litery, cyfry i myślniki. Instalator zaproponuje ją na podstawie nazwy organizacji |
| The first administrator's e-mail | e-mail pierwszego administratora. Zostaje właścicielem organizacji i operatorem całej instalacji |
| Their name | jego imię i nazwisko |
| Their language | cs, en, de, fr, es, it, pt albo pl (domyślnie en) |
| Run the updater | yes albo no (domyślnie yes). Updater pozwala aktualizować, zmieniać liczbę procesów, wymieniać klucz szyfrowania i robić kopie zapasowe z interfejsu webowego. Ma dostęp do Dockera, co oznacza prawa roota na serwerze. Bez niego wszystko działa z wiersza poleceń |
| HTTPS certificate file (PEM) | ścieżka do certyfikatu, jeśli HTTPS ma się kończyć bezpośrednio w draften; w przeciwnym razie zostaw puste |
| Its private key file | ścieżka do klucza certyfikatu |
Z certyfikatem adres musi zaczynać się od https://. Każdą odpowiedź można też podać od razu w poleceniu, więc instalację da się oskryptować; opcje wypisuje ./draften help:
sudo ./draften install --url https://draften.firma.cz --org "Firma sp. z o.o." \
--admin-email jan@firma.cz --admin-name "Jan Novák" --locale en --updater yes
Krok 6: Co zrobi instalator
- Zapisze ustawienia i sekrety do pliku
.env– czytelnego tylko dla właściciela. Hasła bazy danych, klucz szyfrowaniaMASTER_KEYi sekret sesji wygeneruje losowo i nigdzie ich nie wypisze. - Utworzy foldery
data/,backups/oraz pierwszą organizację z administratorem. - Uruchomi draften i sprawdzi, czy odpowiada.
- Na końcu wypisze adres i link do ustawienia hasła pierwszego administratora oraz przypomni o zapisaniu kopii
.env.
Gdy pierwsze uruchomienie się nie powiedzie („the first start failed”), zajrzyj do docker compose ps i docker compose logs. Gdy instalator nie wypisze linku, znajdziesz go poleceniem docker compose logs worker | grep set-password – worker wypisuje go przy każdym starcie, dopóki hasło nie istnieje.
Od razu zapisz kopię .env poza serwerem – przynajmniej wartość MASTER_KEY. Tym kluczem są zaszyfrowane dostępy do skrzynek, klucze modeli i hasła do wysyłki poczty. Bez niego nikt ich nie odczyta, nawet z kopii zapasowej – a my go nie mamy.
Krok 7: Opublikuj draften przez HTTPS
Zależnie od tego, gdzie kończy się HTTPS, wybierz jeden wariant. Rekord DNS swojego adresu skieruj na serwer (albo na proxy).
HTTPS bezpośrednio w draften
Jeśli instalator dostał certyfikat, draften nasłuchuje na porcie 443 i z portu 80 przekierowuje na HTTPS. Wystarczy DNS i otwarte porty 80 i 443. Certyfikat można dodać także później, a tym samym poleceniem wymienisz go po odnowieniu bez utraty choćby jednego żądania:
sudo ./draften certificate cert.pem key.pem --url https://draften.firma.cz
O odnawianie certyfikatu (na przykład klientem ACME) dbasz samodzielnie; po każdym odnowieniu uruchom to polecenie.
Twoje reverse proxy
Bez certyfikatu draften nasłuchuje tylko na 127.0.0.1:8085. Proxy na tej samej maszynie przesyła żądania na ten adres i przekazuje nagłówki Host i X-Forwarded-Proto. Na przykład dla Caddy (certyfikat zdobędzie sam):
draften.firma.cz {
reverse_proxy 127.0.0.1:8085
}
albo dla 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;
}
}
Gdy proxy działa na innej maszynie, ustaw w .env WEB_BIND=0.0.0.0:8085, uruchom sudo docker compose up -d i udostępnij port 8085 tylko proxy (zobacz krok 13).
Cloudflare Tunnel
Nie potrzebuje żadnego otwartego portu. W Cloudflare Zero Trust utwórz tunel i skopiuj jego token. Do .env wpisz CLOUDFLARE_TUNNEL_TOKEN=<token>, do COMPOSE_PROFILES dodaj tunnel (na przykład COMPOSE_PROFILES=updater,tunnel) i uruchom:
sudo docker compose up -d
W Cloudflare dodaj potem przy tunelu publiczny adres (Public hostname) prowadzący na http://127.0.0.1:8085. WEB_BIND zostaw na 127.0.0.1:8085. Obraz cloudflared Docker pobierze z Docker Hub – nie ma go w paczce.
Krok 8: Ustaw hasło i zaloguj się
Otwórz link, który wypisał instalator, ustaw hasło – od razu się zalogujesz. Link działa raz i jest ważny 7 dni. Jak wygląda strona z ustawieniem hasła, pokazuje instrukcja Logowanie.
Nigdzie nie kopiuj ani nie przekazuj dalej tego linku – kto go ma, ten ustawi hasło administratora.
Krok 9: Prześlij licencję
W interfejsie otwórz Instalacja → Instalacja, na dole na karcie Licencja wybierz plik i prześlij go. Dopóki instalacja nie ma licencji, asystenci nie przetwarzają poczty i nie można utworzyć skrzynki ani asystenta. Z licencją updater sam pilnuje nowych wydań. Więcej w Licencji.
Krok 10: Ustaw domyślne klucze i wysyłkę poczty
Na tej samej stronie Instalacja:
- Domyślne klucze API – klucze modeli dla wszystkich organizacji i skrzynek bez własnych. Zobacz Klucze API modeli.
- Domyślna wysyłka poczty – skąd przychodzą zaproszenia i linki do ustawienia hasła: Nadawca (adres), Nadawca (nazwa), Serwer SMTP, Port (domyślnie 587), Szyfrowanie (STARTTLS na 587, TLS na 465), Użytkownik i Hasło – albo klucz API Brevo. Przyciskiem Wyślij wiadomość testową sprawdzisz, czy poczta wychodzi. Bez nadawcy nikt nie dostanie zaproszenia ani linku do hasła. Zobacz Wysyłka poczty.
Krok 11: Podłącz pocztę i ludzi
- Zdecyduj, jak asystent dostanie się do poczty, i przygotuj to w Microsoft albo Google: Microsoft 365, Google Workspace, inna skrzynka przez IMAP.
- Kto ma się logować kontem Microsoft lub Google, ustaw w Logowaniu członków.
- Dodaj i podłącz skrzynkę.
- Skonfiguruj asystenta kreatorem.
- Zaproś kolejne osoby – Osoby i role.
Krok 12: Sprawdź, czy wszystko działa
sudo ./draften status
wypisuje wersję, stan interfejsu webowego i workerów, stan HTTPS i kopii zapasowej. W interfejsie strona Utrzymanie pokazuje, czy workery się zgłaszają – zobacz Utrzymanie i przepustowość. Gdy coś nie działa, pomoże Rozwiązywanie problemów; plik dla naszego wsparcia utworzy sudo ./draften diagnose.
Krok 13: Zabezpiecz serwer
Kto ma dostęp do serwera, ma dostęp do wszystkiego: do poczty w wiadomościach, do .env z kluczem i do kopii zapasowych. Dlatego chroń serwer jak serwer pocztowy.
Firewall. Z zewnątrz przepuszczaj tylko to, co potrzebne:
- przy HTTPS w draften porty 80 i 443,
- przy reverse proxy na innej maszynie port 8085 tylko z adresu proxy,
- przy Cloudflare Tunnel żadnego,
- SSH tylko z adresów, z których zarządzasz serwerem.
Docker omija reguły UFW (i firewalld) dla portów, które publikuje. ufw deny 8085 nie zamknie portu, który Docker otworzył na 0.0.0.0. Dlatego zostaw WEB_BIND na 127.0.0.1:8085, gdzie się da; gdzie nie, ogranicz dostęp firewallem przed serwerem albo regułami w łańcuchu DOCKER-USER.
Połączenia wychodzące wystarczy zezwolić na adresy z Obsługiwanego środowiska.
SSH. Logowanie tylko kluczem (PasswordAuthentication no), bez bezpośredniego logowania roota (PermitRootLogin no), administratorzy z własnymi kontami i sudo.
Kto ma dostęp do Dockera. Członkostwo w grupie docker oznacza prawa roota. Dawaj je tylko administratorom serwera.
Aktualizacje systemu. Włącz automatyczne aktualizacje bezpieczeństwa (na Ubuntu unattended-upgrades) i aktualizuj Dockera razem z systemem. Aktualizacje draften zapewnia updater – zobacz Aktualizacja przez updater.
Updater. Ma dostęp do Dockera, czyli prawa roota. Jeśli go nie potrzebujesz, wyłącz go: w .env usuń updater z COMPOSE_PROFILES i w katalogu instalacji uruchom sudo docker compose rm -sf updater. Aktualizacje i kopie zapasowe robisz wtedy z wiersza poleceń.
Pliki instalacji. .env jest czytelny tylko dla właściciela, folder backups/ także – zostaw to tak. Nie udostępniaj katalogu instalacji.
Kopie zapasowe poza serwerem. draften codziennie robi kopię zapasową bazy danych do backups/ na tym samym dysku. Ustaw kopiowanie backups/ i .env w inne miejsce, w postaci zaszyfrowanej – zrzuty zawierają pocztę. Szczegóły: Kopia zapasowa i odtwarzanie.
Klucz szyfrowania. Gdy odejdzie ktoś, kto znał .env, wymień MASTER_KEY (sudo ./draften rotate-key albo w Instalacja → Instalacja) i nową kopię .env zapisz poza serwerem.
Dalej
- Aktualizacja przez updater – nowa wersja jednym przyciskiem,
- Aktualizacja z wiersza poleceń,
- Kopia zapasowa i odtwarzanie,
- Rozwiązywanie problemów.