Zainstaluj SealRoute na swoim serwerze

Wymagania wstępne

• Host z systemem Linux (Ubuntu 22.04+ lub dowolna nowoczesna dystrybucja) z co najmniej 2 GB RAM i 10 GB dysku.
• Docker Engine (24+) oraz wtyczka Docker Compose v2. Sprawdź poleceniem:

  docker --version
  docker compose version

• Albo publiczna domena (z HTTPS z przodu), albo po prostu port, który kontrolujesz na localhost. Domyślny docker-compose.yml dostarcza odwrotne proxy Caddy, które automatycznie obsługuje HTTPS, gdy ustawisz HOST=twoja.domena.
• Licencja Aplindo. Możesz ją również kupić bezpośrednio z działającej aplikacji w Kroku 5 poniżej.

Krok 1 - Pobierz plik docker-compose

Utwórz katalog roboczy i pobierz produkcyjny plik compose z repozytorium. Łączy on już ze sobą SealRoute, Postgres i Caddy.

mkdir sealroute && cd sealroute
curl -L https://raw.githubusercontent.com/sealroute/sealroute/main/docker-compose.yml -o docker-compose.yml
curl -L https://raw.githubusercontent.com/sealroute/sealroute/main/deploy.sh         -o deploy.sh
chmod +x deploy.sh

Jeśli wolisz sklonować cały pakiet wdrożeniowy: git clone https://github.com/sealroute/sealroute.git && cd sealroute. Tak czy inaczej, kolejne kroki są takie same.

Krok 2 - Skonfiguruj swoje środowisko

SealRoute odczytuje swoją konfigurację ze zmiennych środowiskowych. Utwórz plik .env obok pliku compose. Niezbędne minimum:

# Where the app is reachable from a browser. Use https://your.domain in
# production or http://localhost:3000 for a local trial.
APP_URL=https://your.domain
HOST=your.domain

# Generate with `openssl rand -hex 64` and keep it secret.
SECRET_KEY_BASE=replace-me-with-a-long-random-string

# --- Aplindo licensing ------------------------------------------------------
APLINDO_LICENSE_API_URL=https://license.aplindo.com
APLINDO_LICENSE_PRODUCT_SLUG=SealRoute
APLINDO_LICENSE_DEFAULT_AMOUNT_IDR=5000000.00
APLINDO_LICENSE_HEARTBEAT_SECONDS=3600

Pełniejszy przykład z opcjonalnymi ustawieniami znajduje się w .env.example.

Krok 3 - Uruchom stos

Uruchom SealRoute, Postgres i odwrotne proxy w tle:

docker compose up -d

Obserwuj logi rozruchu, aż zobaczysz Pumę nasłuchującą na tcp://0.0.0.0:3000:

docker compose logs -f app

Pierwsze uruchomienie wykonuje również migracje bazy danych. Na hoście z 2 GB zwykle kończy się to w niecałą minutę.

Krok 4 - Konfiguracja początkowa

Otwórz aplikację w przeglądarce. Ponieważ nie ma jeszcze żadnych użytkowników, SealRoute przekierowuje Cię na stronę /setup. Tutaj tworzysz pierwsze konto administratora i metadane swojego konta.

Wypełnij:

• Imię / Nazwisko - Twoje imię i nazwisko jako pierwszego administratora.
• E-mail - to login administratora i miejsce, do którego będą wysyłane powiadomienia o podpisach.
• Nazwa firmy - wyświetlana podpisującym w e-mailach i na stronie podpisu.
• Hasło - co najmniej 8 znaków, zalecana mieszanka liter i cyfr.
• Adres URL aplikacji - wstępnie wypełniony z APP_URL w Twoim .env. Używany do generowania linków do podpisu w e-mailach.
• Język - domyślny język interfejsu dla nowych podpisujących.

Kliknij Wyślij. SealRoute tworzy konto, loguje Cię i przekierowuje na stronę /license.

Krok 5 - Kup licencję

Samodzielnie hostowana instancja SealRoute potrzebuje aktywnej licencji, aby odblokować ekrany po zalogowaniu. Strona /license ma dwie karty: Kup licencję u góry i Aktywuj licencję poniżej.

Na karcie Kup licencję ustaw liczbę stanowisk, których potrzebujesz. Cena jednostkowa pochodzi z Twojego ustawienia APLINDO_LICENSE_DEFAULT_AMOUNT_IDR (obecnie IDR 1.499.000 za stanowisko), a suma jest automatycznie przeliczana, gdy zmieniasz liczbę stanowisk.

Kliknij Kup licencję. SealRoute otwiera okno modalne z ramką iframe płatności Aplindo. Dokończ płatność w tym miejscu. Gdy transakcja się powiedzie, Aplindo wysyła klucz licencyjny na podany adres, a ten sam klucz jest również wyświetlany na stronie potwierdzenia płatności.

Krok 6 - Aktywuj swoją licencję

Skopiuj klucz licencyjny ze strony potwierdzenia lub z e-maila, a następnie wklej go na kartę Aktywuj licencję na /license:

Kliknij Aktywuj. SealRoute łączy się z serwerem licencji Aplindo, wiąże klucz z tą maszyną i przeładowuje się. U góry zobaczysz kartę Bieżąca licencja ze statusem active, slugiem produktu, ID licencji, ID maszyny, datą wygaśnięcia i znacznikiem czasu ostatniego heartbeatu.

SealRoute planuje zadanie heartbeat, które ponownie sprawdza licencję w Aplindo co APLINDO_LICENSE_HEARTBEAT_SECONDS sekund (domyślnie: co godzinę). Jeśli licencja zostanie cofnięta lub wygaśnie, kolejny heartbeat to odzwierciedli.

Krok 7 - Gotowe

SealRoute jest teraz w pełni operacyjny. Wejdź na /, a wylądujesz na pustym pulpicie Szablonów Dokumentów, gotowym na Twój pierwszy przesłany plik.