Dla administratorów
← Wszystkie tematy

Instalacja krok po kroku

Od pustego serwera do pierwszego logowania: sprawdzenie paczki, ./draften install, HTTPS, licencja i pierwsza skrzynka.

Całą instalację wykonuje jedno polecenie, ./draften install, uruchomione w rozpakowanej paczce. Oto postępowanie od pustego serwera do pierwszego logowania. Z czego składa się instalacja i co gdzie leży, opisuje strona Instalacja na własnym serwerze.

Krok 1: Przygotuj serwer

Serwer nie potrzebuje do instalacji internetu: paczka przynosi wszystkie obrazy.

Krok 2: Sprawdź, czy paczka jest od nas

Dla każdej paczki wydania draften-<version>.tar publikujemy jej sumę kontrolną. Oblicz ją i porównaj:

sha256sum draften-<version>.tar

Każdą późniejszą aktualizację instalacja sprawdza sama względem naszych kluczy. Pierwsza instalacja nie ma jednak z czym porównać – to jest jej sprawdzenie. Jeśli sumy kontrolne się różnią, nie instaluj paczki i skontaktuj się z nami.

Krok 3: Rozpakuj paczkę i uruchom instalator

Wybierz katalog, w którym będzie instalacja, rozpakuj do niego paczkę i uruchom instalator:

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

Instalator wczyta obrazy, sprawdzi paczkę i zapyta o to, czego potrzebuje.

Krok 4: Odpowiedz na pytania instalatora

Każdą odpowiedź można też podać od razu w poleceniu, więc instalację da się oskryptować; ./draften help wypisuje opcje. Na przykład:

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

Krok 5: Przechowuj kopię .env poza serwerem

Instalator zapisuje ustawienia i sekrety w pliku .env w katalogu instalacji. Skopiuj go – przynajmniej wartość MASTER_KEY – w bezpieczne miejsce poza serwerem. Ten klucz szyfruje dostęp 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 6: Ustaw hasło i zaloguj się

Na końcu instalator wypisuje link do ustawienia hasła pierwszego administratora. Otwórz go w przeglądarce i ustaw hasło – od razu się zalogujesz. Link działa raz i jest ważny 7 dni. Jak wygląda strona z hasłem, pokazuje instrukcja Logowanie.

Link wypisuje tylko instalator. Nigdzie go nie kopiuj ani nie przekazuj dalej – kto go ma, ten ustawi hasło administratora.

Krok 7: Opublikuj adres

Zależnie od tego, co wybrano w kroku 4:

Certyfikat można dodać także później:

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

Krok 8: Prześlij licencję

Licencję wysyłamy jako plik licence-<numer>.json. W interfejsie otwórz Instalacja → Instalacja, wybierz plik na karcie Licencja na dole i prześlij go. Dopóki instalacja nie ma licencji, asystenci nie przetwarzają poczty i nie można utworzyć skrzynki ani asystenta. Więcej w Licencji.

Krok 9: Ustaw domyślne klucze i wysyłkę poczty

Na tej samej stronie Instalacja ustaw Domyślne klucze API do modeli i Domyślną wysyłkę poczty (skąd przychodzą zaproszenia i linki do haseł). Obowiązują w każdej organizacji, która nie ustawi własnych. Szczegóły: Klucze API modeli i Wysyłka poczty.

Krok 10: Podłącz skrzynkę i skonfiguruj asystenta

Od tego miejsca postępujesz jak w każdej innej instalacji:

  1. Dodaj i podłącz skrzynkę.
  2. Skonfiguruj asystenta kreatorem.
  3. Zaproś kolejne osoby – Osoby i role.

Krok 11: Sprawdź, czy wszystko działa

./draften status

wypisuje wersję, stan interfejsu webowego i workerów, stan HTTPS i zrzuty bazy danych. W interfejsie strona Utrzymanie pokazuje, czy workery się zgłaszają – zobacz Utrzymanie i przepustowość.

Dalej

Wersja tekstowa