Plik konfiguracyjny i zmienne środowiskowe
Zmienisz ustawienie serwera we właściwym miejscu i bezpiecznie przekażesz mu sekrety.
Konfiguracja serwera leży w pliku /etc/gadka/gadka.yaml. Instalator tworzy go na podstawie Twoich odpowiedzi.
Skąd serwer bierze ustawienia
Serwer czyta ustawienia z trzech źródeł. Każde następne nadpisuje poprzednie:
- wartości domyślne wbudowane w program,
- plik YAML wskazany flagą
--config(albo zmiennąGADKA_CONFIG), - zmienne środowiskowe
GADKA_*.
Jak zmienić ustawienie
- Otwórz plik jako root:
sudo nano /etc/gadka/gadka.yaml. - Zmień wartość i zapisz plik.
- Uruchom serwer ponownie:
sudo systemctl restart gadka- Sprawdź, czy wystartował:
systemctl status gadka.
Serwer sprawdza konfigurację przy starcie. Gdy coś jest nie tak, nie uruchomi się, a przyczynę pokaże journalctl -u gadka -n 30.
Zmienne środowiskowe
Każdy klucz z pliku ma odpowiednik w zmiennej: weź ścieżkę klucza, zamień kropki na podkreślenia, zapisz wielkimi literami i dodaj GADKA_ na początku.
| Klucz w pliku | Zmienna |
|---|---|
log.level | GADKA_LOG_LEVEL |
db.password_file | GADKA_DB_PASSWORD_FILE |
link_safety.source | GADKA_LINK_SAFETY_SOURCE |
api.trusted_proxies | GADKA_API_TRUSTED_PROXIES |
Listy podajesz po przecinku. Listy dostawców SSO (auth.oidc.providers) nie da się ustawić zmienną, tylko w pliku.
W instalacji natywnej zmienną dodasz poleceniem sudo systemctl edit gadka:
[Service]
Environment=GADKA_LOG_LEVEL=debugSekrety
Haseł i kluczy nigdy nie wpisujesz wprost do konfiguracji. Klucze z końcówką _file wskazują plik, w którym leży sekret.
sudo install -o root -g gadka -m 0640 /dev/null /etc/gadka/oidc-client-secret
sudo nano /etc/gadka/oidc-client-secretPlik musi być czytelny dla grupy gadka, bo serwer działa jako użytkownik gadka.
Najważniejsze sekcje
| Sekcja | Do czego |
|---|---|
log | poziom (debug, info, warn, error) i format (json, text) logów |
db | baza danych: driver (sqlite, postgres, mysql) i parametry połączenia |
auth | tokeny, minimalna długość hasła, SSO (oidc), wymóg 2FA dla administratorów (mfa) |
api | publiczny adres (public_url), adres nasłuchu, zaufane proxy |
gateway | połączenia aplikacji, QUIC, certyfikat TLS |
ratelimit | limity prób logowania i wyszukiwania |
telemetry | port stanu i metryk, śledzenie OpenTelemetry |
s3, antivirus, files | przechowywanie i skanowanie plików |
link_previews, link_safety | podglądy i sprawdzanie linków |
calendar, crypto | integracja kalendarzy i klucze szyfrujące |
federation | rozmowy z innymi organizacjami |
license | plik klucza licencji importowany przy starcie |
web | katalog z wersją przeglądarkową |
Zaufane proxy
Serwer stoi za dołączonym reverse proxy, które działa na tej samej maszynie. Instalator wpisuje jego adres do konfiguracji:
api:
trusted_proxies: ["127.0.0.1"]Dzięki temu serwer zna prawdziwy adres każdego klienta i limit prób logowania liczy się osobno dla każdego komputera.