# Aktualizacja przez updater – instrukcja krok po kroku

Gdy w instalacji działa updater, aktualizujesz draften na stronie Instalacja jednym przyciskiem. Aplikacja działa dalej, a gdyby nowa wersja sprawiała problemy, powrót jest równie prosty.

**Zanim zaczniesz**

- **Operator instalacji** — Część menu Instalacja widzi tylko operator (w interfejsie superadmin).
- **Działający updater** — Włącza się go przy instalacji (COMPOSE_PROFILES=updater w .env). Bez niego aktualizujesz poleceniem ./draften update.

## Krok 1 z 8: Otwórz stronę Instalacja

Na ekranie: W menu w części Instalacja strona Instalacja; u góry karta Wersja.

Zrób to: Wiersz **Działa** pokazuje wersję, która teraz obsługuje ruch. Wiersz **Updater** musi mówić **działa** – inaczej nie zaktualizujesz tutaj i użyjesz wiersza poleceń.

> Wskazówka: Updater sam szuka nowych wersji, a wiersz mówi, kiedy zrobił to ostatnio. Pobiera je kluczem z licencji; na maszynie bez internetu proponuje wydanie, które skopiujesz do folderu `updates/` w katalogu instalacji.

## Krok 2 z 8: Przeczytaj, co nowego

Na ekranie: Część Nowe wersje z proponowaną wersją.

Zrób to: Przy wersji widać datę wydania, rozmiar i informacje o wydaniu. Przejrzyj je, żeby wiedzieć, co zmieni się dla ludzi w organizacjach.

> Wskazówka: Wydanie, które wycofaliśmy, ma etykietę **wycofana** i powód; updater go nie proponuje.

## Krok 3 z 8: Uruchom aktualizację

Na ekranie: Pod informacjami przycisk z numerem nowej wersji.

Zrób to: Kliknij **Zaktualizuj do 2026.9.2**.

> Wskazówka: Aplikacja w trakcie aktualizacji działa dalej: nowa wersja uruchamia się obok obecnej i przejmuje ruch dopiero wtedy, gdy jest sprawna. Wcześniej updater zrzuca bazę danych do folderu `backups/`.

## Krok 4 z 8: Potwierdź

Na ekranie: Okno z pytaniem, czy zaktualizować do nowej wersji.

Zrób to: Kliknij **Zaktualizuj**.

## Krok 5 z 8: Śledź postęp

Na ekranie: Na karcie Wersja zlecenie Aktualizacja do 2026.9.2 ze statusem w toku.

Zrób to: W części **Postęp** updater dopisuje swoje wiersze: sprawdzenie paczki, zrzut bazy danych, migracje, uruchomienie nowej wersji. Strona sama odświeża się co dwie sekundy.

> Wskazówka: Dopóki zlecenie **oczekuje**, możesz kliknąć **Anuluj zlecenie**. Gdy aktualizacja się nie powiedzie, obecna wersja dalej obsługuje ruch, a błąd pojawi się na czerwono w zleceniu.

## Krok 6 z 8: Wczytaj nową wersję

Na ekranie: Zielony pasek Działa wersja 2026.9.2.

Zrób to: Nowa wersja przejęła ruch. Strona w twojej przeglądarce jest jednak jeszcze ze starej – kliknij **Wczytaj nową wersję**.

## Krok 7 z 8: Gdy nowa wersja sprawia problemy

Na ekranie: Pod wersją propozycja powrotu do poprzedniej.

Zrób to: Kliknij **Przywróć 2026.9.1** i potwierdź. Updater przełączy z powrotem na wersję, która obsługiwała ruch przed aktualizacją; aplikacja w tym czasie działa dalej.

> Wskazówka: Po aktualizacji poprzednia wersja działa dalej bez ruchu, więc powrót jest natychmiastowy. Powrót do jeszcze starszej wersji oznacza odtworzenie zrzutu bazy danych – opisuje to strona Aktualizacja z wiersza poleceń.

## Krok 8 z 8: Historia zleceń

Na ekranie: Na dole strony karta Historia zleceń.

Zrób to: Tu jest dziesięć ostatnich zleceń dla updatera – aktualizacje, powroty, zmiany liczby procesów i wymiany klucza: kto zlecił, kiedy się zakończyły i ewentualny błąd.

**Instalacja działa w nowej wersji** — Aktualizacja nie dotyka ustawień asystentów, wytycznych ani poczty – wszystko to zostaje w bazie danych.

- **Nie ma updatera?** — Strona Aktualizacja z wiersza poleceń opisuje ./draften update, sprawdzanie paczki i powrót do starszej wersji.
- **Zrzuty bazy danych** — Przed każdą aktualizacją baza danych jest zrzucana do backups/ (przechowywane są trzy ostatnie). Kopiuj je razem z .env poza serwer – zobacz Kopia zapasowa i odtwarzanie.