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
- Pobierz instalator serwera ze strony gadka.lemric.com/pobierz.
- Skopiuj plik na serwer i uruchom jako root:
chmod +x gadka-server-<wersja>-linux-amd64.run
sudo ./gadka-server-<wersja>-linux-amd64.runKrok 2. Odpowiedz na pytania
Wartość w nawiasie kwadratowym jest domyślna. Enter ją przyjmuje.
| Pytanie | Co 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.comSprawdź usługi i gotowość serwera:
systemctl status gadka gadka-proxy
gadka healthcheck && echo OKObie usługi powinny mieć stan active (running), a drugie polecenie wypisać OK.
Co zostało zainstalowane
| Ścieżka | Zawartość |
|---|---|
/usr/local/bin/gadka | serwer i narzędzie administracyjne |
/usr/local/bin/gadka-caddy | reverse proxy HTTPS |
/etc/gadka/gadka.yaml | konfiguracja serwera |
/etc/gadka/Caddyfile | konfiguracja reverse proxy |
/etc/gadka/tls-cert.pem, /etc/gadka/tls-key.pem | kopie Twojego certyfikatu i klucza |
/etc/gadka/jwt-signing-key.pem, /etc/gadka/mfa-key | klucze wygenerowane przy instalacji |
/etc/gadka/db-password | hasło bazy (tylko PostgreSQL i MySQL) |
/var/lib/gadka | dane, w tym baza SQLite |
gadka.service, gadka-proxy.service | usługi systemd |
/etc/systemd/system/gadka.service.d/10-credentials.conf | dostę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
| Komunikat | Co zrobić |
|---|---|
Błąd: uruchom instalator jako root | uruchom przez sudo |
Błąd: pakiet jest przeznaczony dla amd64/x86_64 | użyj serwera z procesorem x86-64 |
Błąd: wymagany jest openssl | zainstaluj pakiet openssl |
Błąd: nie można odczytać certyfikatu: … | popraw ścieżkę do pliku PEM |
usługa gadka nie startuje | journalctl -u gadka -n 50 pokaże błąd konfiguracji |