Spis treści dokumentacji

Kopie zapasowe i odtwarzanie

Zrobisz spójną kopię danych Gadki i odtworzysz z niej serwer.

Co trzeba zabezpieczyć

CoGdzieUwagi
baza danych/var/lib/gadka/gadka.db (SQLite) albo serwer PostgreSQL lub MySQLwszystkie rozmowy, konta i ustawienia
konfiguracja i klucze/etc/gadkaw tym mfa-key i jwt-signing-key.pem
pliki użytkownikówmagazyn S3tylko gdy włączyłeś pliki

Katalog /var/lib/gadka/nats nie wymaga kopii.

Kopia bazy SQLite

Polecenie robi spójną kopię działającej bazy. Nie musisz zatrzymywać serwera.

sudo gadka --config /etc/gadka/gadka.yaml admin backup --out /var/lib/gadka/gadka-$(date +%F-%H%M).db

Oczekiwany wynik:

backup written to /var/lib/gadka/gadka-2026-11-19-0200.db

Plik docelowy nie może istnieć: polecenie nigdy nie nadpisuje starej kopii.

Skopiuj plik poza serwer i usuń go z /var/lib/gadka. Kopie szyfruj i przechowuj na innej maszynie.

Kopia bazy PostgreSQL lub MySQL

Polecenie gadka admin backup działa tylko dla SQLite. Dla pozostałych baz użyj ich narzędzi, np. pg_dump albo mysqldump.

Kopia konfiguracji i kluczy

sudo tar -czf gadka-etc-$(date +%F).tar.gz -C /etc gadka

Archiwum zawiera klucze. Przechowuj je tak samo ostrożnie jak hasła.

Codzienna kopia automatycznie

Przykładowy wpis w crontabie roota (sudo crontab -e), codziennie o 2:00:

0 2 * * * /usr/local/bin/gadka --config /etc/gadka/gadka.yaml admin backup --out /var/lib/gadka/gadka-$(date +\%F).db

Zadbaj o przenoszenie kopii poza serwer i usuwanie starych plików.

Odtworzenie bazy SQLite

  1. Zatrzymaj usługi:
sudo systemctl stop gadka-proxy gadka
  1. Podmień bazę i usuń pliki pomocnicze starej bazy:
sudo install -o gadka -g gadka -m 0640 gadka-kopia.db /var/lib/gadka/gadka.db
sudo rm -f /var/lib/gadka/gadka.db-wal /var/lib/gadka/gadka.db-shm
  1. Uruchom usługi:
sudo systemctl start gadka gadka-proxy
  1. Sprawdź: gadka healthcheck && echo OK, a potem zaloguj się w aplikacji.

Odtworzenie na nowej maszynie

  1. Zainstaluj Gadkę instalatorem na nowej maszynie.
  2. Zatrzymaj usługi, przywróć /etc/gadka z archiwum i bazę jak wyżej.
  3. Uruchom usługi.

Co dalej