Spis treści dokumentacji

Instalacja instalatorem .run

Zainstalujesz serwer Gadki na Linuksie i sprawdzisz, że działa.

Instalator to jeden plik. Zawiera serwer Gadki i reverse proxy do HTTPS, niczego nie pobiera z sieci. Zadaje kilka pytań, zapisuje konfigurację i uruchamia usługi systemd.

Zanim zaczniesz

  • Linux x86-64 z systemd i poleceniem openssl. Zobacz Wymagania.
  • Dostęp root.
  • Domena wskazująca na serwer.
  • Na serwerze: certyfikat TLS z pełnym łańcuchem i klucz prywatny, oba w PEM. Zobacz Domena i HTTPS.
  • Tylko dla PostgreSQL lub MySQL: wcześniej utworzona pusta baza i użytkownik z hasłem.

Krok 1. Pobierz i uruchom instalator

  1. Pobierz instalator serwera ze strony gadka.lemric.com/pobierz.
  2. Skopiuj plik na serwer i uruchom jako root:
chmod +x gadka-server-<wersja>-linux-amd64.run
sudo ./gadka-server-<wersja>-linux-amd64.run

Krok 2. Odpowiedz na pytania

Wartość w nawiasie kwadratowym jest domyślna. Enter ją przyjmuje.

PytanieCo wpisać
Domena serwera (bez https:// i portu)np. gadka.example.com
Publiczny port TCP/UDP [6543]zostaw 6543, jeśli nie masz powodu go zmieniać
Wybór [1] (baza danych)1 SQLite, 2 PostgreSQL, 3 MySQL
Ścieżka bazy SQLite [/var/lib/gadka/gadka.db]Enter
Plik pełnego łańcucha certyfikatu TLS (PEM)ścieżka do pliku certyfikatu
Plik prywatnego klucza TLS (PEM)ścieżka do pliku klucza
Źródło Listy Ostrzeżeń CERT Polska (URL lub firmowy mirror)Enter albo adres własnej kopii listy

Gdy wybierzesz PostgreSQL lub MySQL, instalator zapyta jeszcze o Host bazy, Port bazy, Nazwa istniejącej bazy, Użytkownik bazy i Hasło użytkownika bazy, a dla PostgreSQL także o Tryb TLS PostgreSQL (require/verify-full/disable).

Krok 3. Sprawdź wynik

Po ostatnim pytaniu instalator wypisuje Sprawdzanie konfiguracji i migracja bazy…, tworzy schemat bazy, włącza usługi i kończy komunikatem:

Gotowe. Pracownicy wpisują w aplikacji domenę: gadka.example.com

Sprawdź usługi i gotowość serwera:

systemctl status gadka gadka-proxy
gadka healthcheck && echo OK

Obie usługi powinny mieć stan active (running), a drugie polecenie wypisać OK.

Co zostało zainstalowane

ŚcieżkaZawartość
/usr/local/bin/gadkaserwer i narzędzie administracyjne
/usr/local/bin/gadka-caddyreverse proxy HTTPS
/etc/gadka/gadka.yamlkonfiguracja serwera
/etc/gadka/Caddyfilekonfiguracja reverse proxy
/etc/gadka/tls-cert.pem, /etc/gadka/tls-key.pemkopie Twojego certyfikatu i klucza
/etc/gadka/jwt-signing-key.pem, /etc/gadka/mfa-keyklucze wygenerowane przy instalacji
/etc/gadka/db-passwordhasło bazy (tylko PostgreSQL i MySQL)
/var/lib/gadkadane, w tym baza SQLite
gadka.service, gadka-proxy.serviceusługi systemd
/etc/systemd/system/gadka.service.d/10-credentials.confdostęp usługi do identyfikatorów maszyny, potrzebny do licencji

Usługi działają jako użytkownik systemowy gadka, bez uprawnień roota.

Ponowne uruchomienie instalatora

Instalator uruchomiony na maszynie, na której Gadka już jest, niczego nie instaluje od nowa. Wyświetla Gadka — aktualizacja istniejącej instalacji i po potwierdzeniu aktualizuje serwer, zachowując konfigurację, klucze i dane. Zobacz Aktualizacja serwera.

Rozwiązywanie problemów

KomunikatCo zrobić
Błąd: uruchom instalator jako rooturuchom przez sudo
Błąd: pakiet jest przeznaczony dla amd64/x86_64użyj serwera z procesorem x86-64
Błąd: wymagany jest opensslzainstaluj pakiet openssl
Błąd: nie można odczytać certyfikatu: …popraw ścieżkę do pliku PEM
usługa gadka nie startujejournalctl -u gadka -n 50 pokaże błąd konfiguracji

Co dalej