> For the complete documentation index, see [llms.txt](https://helpcenter.xopero.com/xopero-one-en/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://helpcenter.xopero.com/xopero-one-en/pl/aktualizacje/agent-xopero-one/aktualizacja-w-kontenerze-docker.md).

# Aktualizacja w kontenerze Docker

Ten artykuł wyjaśnia, jak zaktualizować agenta Xopero ONE zainstalowanego wewnątrz kontenera Docker.

#### Utrzymywanie kontenera agenta w aktualnej wersji zapewnia optymalną wydajność oraz dostęp do najnowszych funkcji i usprawnień.

***

## Aktualizacja agenta Xopero ONE

{% tabs %}
{% tab title="Docker" %}

## Wymiana agenta

{% hint style="danger" %}
Jedynym sposobem na aktualizację agenta zainstalowanego w kontenerze jest **usunięcie istniejącej wersji i utworzenie nowej**.
{% endhint %}

1. Pobierz nowy obraz i usuń stary kontener z agentem, używając następujących komend:

```dockerfile
docker pull xopero/xone-agent:latest
docker stop xone-agent && docker rm xone-agent
```

2. Utwórz nowy kontener z agentem **Xopero ONE**:

```dockerfile
docker run -d \
  --name xone-agent \
  -e ManagementServiceUrl="<your_xopero_service_URL>" \
  -e XoperoOverriddenHostName="<device_name>" \
  -v /opt/xone-agent/data:/app/Xopero \
  --restart unless-stopped \
  xopero/xone-agent:latest
```

* `<your_xopero_service_URL>` — adres **Xopero ONE Management Service** wraz z portem (np. `123.456.7.890:28555`).
* `<device_name>` — niestandardowa nazwa kontenera **Docker**.

3. Po wykonaniu tych kroków agent **Xopero** powinien zostać zaktualizowany do najnowszej wersji.
   {% endtab %}

{% tab title="QNAP NAS (CS > 3.0)" %}
{% hint style="warning" %}
Ta metoda wymaga aplikacji **Container Station w wersji 3.0 lub nowszej**.
{% endhint %}

## Proces aktualizacji

1. Otwórz **Container Station** na swoim urządzeniu **QNAP**.
2. Zlokalizuj i wybierz kontener z agentem, którego chcesz zaktualizować, a następnie kliknij ikonę ⚙️ **Settings** aby otworzyć ustawienia kontenera.

<figure><img src="https://1873867500-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Fwg6DDqlTFok8F9zv6rqa%2Fuploads%2FqFTwX95ErwGbzceHpI81%2Fobraz_2026-08-27_163619692.png?alt=media&amp;token=176faab4-5479-4740-9927-5a9eb776d99d" alt=""><figcaption></figcaption></figure>

3. W menu ustawień wybierz opcję **Recreate** aby rozpocząć aktualizację. Ta akcja zastępuje bieżący kontener nowym, opartym na najnowszym obrazie.

<figure><img src="https://1873867500-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Fwg6DDqlTFok8F9zv6rqa%2Fuploads%2FLyCN0GTlI1i9kTaGOb6q%2Fagentdocker1.png?alt=media&amp;token=4ed66b38-609d-47f6-be1e-8b043918d4ae" alt="" width="170"><figcaption></figcaption></figure>

4. Przełącz się na tryb zaawansowany (**Advanced mode**). Zostaniesz poproszony o adres obrazu z **Docker Hub** — wpisz poniższy adres:

```docker
xopero/xone-agent:latest
```

<figure><img src="https://1873867500-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Fwg6DDqlTFok8F9zv6rqa%2Fuploads%2FfZtVanNrDYyUT30m7GFx%2Fobraz_2026-08-27_163711597.png?alt=media&amp;token=80caaf4b-3482-46dc-96dc-d3a5d6581b7f" alt="" width="563"><figcaption></figcaption></figure>

5. Upewnij się, że zaznaczona jest opcja **Try pulling the image from the registry before creating the container** (gwarantuje to użycie najnowszej wersji). Kliknij **Next** aby kontynuować.
6. Możesz teraz edytować ustawienia kontenera. Dostosuj je w razie potrzeby i kliknij **Next**, aby przejść do podsumowania.

<figure><img src="https://1873867500-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Fwg6DDqlTFok8F9zv6rqa%2Fuploads%2FcXyWBnICq8jUWWNWbkHC%2Fobraz_2026-08-27_163736159.png?alt=media&amp;token=39a75551-aead-4c5c-a7cc-fdd3999bdf62" alt="" width="563"><figcaption></figcaption></figure>

7. Sprawdź podsumowanie zmian. Jeśli wszystko się zgadza, kliknij **Finish**. **Container Station** pobierze najnowszy obraz i utworzy nowy kontener, zachowując dane i ustawienia poprzedniego. To aktualizuje agenta do najnowszej wersji zachowując poprzednie ustawienia i dane.

<figure><img src="https://1873867500-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Fwg6DDqlTFok8F9zv6rqa%2Fuploads%2Fg3Zz807WliLU6cA074W1%2Fobraz_2026-08-27_163759183.png?alt=media&amp;token=4fb6a774-9bcf-48f7-b0a4-e6e5177e991c" alt="" width="563"><figcaption></figcaption></figure>
{% endtab %}

{% tab title="QNAP NAS (CS < 3.0)" %}
{% hint style="danger" %}
W starszych wersjach jedynym sposobem aktualizacji agenta jest usunięcie istniejącej wersji i instalacja nowej. Utworzenie nowego kontenera wymaga ponownej aktywacji urządzenia, więc konieczne będzie ponowne przypisanie go do planów backupu.
{% endhint %}

## Proces aktualizacji

1. Zaloguj się do panelu **Xopero ONE Management Service**.
2. Przejdź do zakładki **Urządzenia** i znajdź agenta **Docker**.
3. Kliknij przycisk ℹ️ szczegóły urządzenia. Sprawdź i zanotuj plany przypisane do agenta (będą potrzebne później). Wszystkie plany można znaleźć w sekcji **Plany backupu**; można też rozwinąć listę klikając **Pokaż więcej**.
4. Usuń stary kontener **agenta Xopero ONE** — w **Container Station**, kliknij ikonę **Remove** w zakładce **Actions** aby usunąć kontener.
5. Po usunięciu kontenera zainstaluj obraz **Docker** agenta **Xopero ONE** ponownie. Następnie dodaj go do wszystkich planów, do których był wcześniej przypisany.
   {% endtab %}

{% tab title="Synology NAS" %}

## Proces aktualizacji

1. W przypadku korzystania z tagu `:latest`, narzędzie **Container Manager** monitoruje dostępność aktualizacji obrazu. Gdy nowa wersja będzie dostępna, w zakładce **Image**, pojawi się powiadomienie ze statusem **Update available**. Aby rozpocząć proces aktualizacji, wystarczy kliknąć przycisk **Update available**..

{% hint style="warning" %}
Jeśli przycisk **Update available** się nie pojawia, mimo że aktualizacja jest dostępna na innych urządzeniach, może być konieczne odczekanie do 12 godzin.
{% endhint %}

<figure><img src="https://1873867500-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Fwg6DDqlTFok8F9zv6rqa%2Fuploads%2F4LO6gIty1XzqaEPkttrQ%2Fimage.png?alt=media&amp;token=6148513c-7fe1-4c9d-835c-bb4f84aa3bd0" alt=""><figcaption></figcaption></figure>

2. Po aktywacji pojawi się komunikat systemowy informujący, że usługi oraz kontener zostaną tymczasowo zawieszone na czas aktualizacji. Potwierdź operację, wybierając przycisk **Update**.

<figure><img src="https://1873867500-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Fwg6DDqlTFok8F9zv6rqa%2Fuploads%2FKmkEG4ZQpKMP9XgMSYIM%2Fimage.png?alt=media&amp;token=cba53d5b-582f-4432-b62c-dd850f05613d" alt=""><figcaption></figcaption></figure>

3. W drugim kroku potwierdzenia system poprosi o ponowne zatwierdzenie aktualizacji poprzez kliknięcie przycisku **Update**.

<figure><img src="https://content.gitbook.com/content/wg6DDqlTFok8F9zv6rqa/blobs/DJKAKj04O52SfnEFrF4c/u3.PNG" alt="" width="563"><figcaption></figcaption></figure>

4. Postęp aktualizacji będzie widoczny na liście operacji. Po pobraniu zaktualizowanego obrazu, kontenery z włączoną opcją auto-start zostaną automatycznie uruchomione ponownie.

<figure><img src="https://1873867500-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Fwg6DDqlTFok8F9zv6rqa%2Fuploads%2F97MQVisaoiq7cTJK4ggp%2Fimage.png?alt=media&amp;token=3031b9cc-be39-419e-b50a-3a81bab4e48d" alt=""><figcaption></figcaption></figure>

5. Aby zweryfikować aktualizację, przejdź do zakładki **Containers** i upewnij się, że kontener działa poprawnie. Następnie, w panelu **Xopero ONE Management Service**, potwierdź, że system wskazuje najnowszą wersję oprogramowania.
   {% endtab %}
   {% endtabs %}