Update within a Docker container
This article explains how to update Xopero ONE agents installed within Docker containers.
Keep your agent container up-to-date, to ensure optimal performance and access to the latest features and improvements.
Updating Xopero ONE agent
Replacing the agent
The only way to update an agent installed in a container is to remove the existing version and create a new one.
Download the new image and remove the old container with the agent using the following command:
docker pull xopero/gitprotect-agent:latest
docker stop xopero-agent && docker rm xopero-agentCreate a new container with the Xopero ONE agent:
docker run -d \
--name xopero-agent \
-e ManagementServiceUrl="<your_xopero_service_URL>" \
-e XoperoOverriddenHostName="<device_name>" \
-v /opt/gitprotect-agent/data:/app/Xopero \
--restart unless-stopped \
xopero/gitprotect-agent:latest<your_xopero_service_URL>— Xopero ONE Management Service address with the port (i.e.,123.456.7.890:28555)<device_name>— custom Docker container name
Once done, the Xopero agent should now be up to date.
This method requires Container Station version 3.0 or later.
Update process
First, open Container Station on your QNAP device.
Locate and select the container running the agent you want to update, then click the settings ⚙️ icon to open the container settings.
In the settings menu, select the Recreate option to proceed with the update. This action replaces the current container with a new one based on the latest image.
Switch to Advanced mode (see illustration below). You will be prompted for the Docker Hub image address — enter the address shown below:
xopero/gitprotect-agent:latest
Make sure you select the option Try pulling the image from the registry before creating the container (this ensures that the latest version of the image is used) and click Next to continue.
You can now edit the container settings as you would when creating a new container. Adjust them if needed, then click Next again to move to the summary page.
Review the summary of the settings and changes. When everything looks correct, click Finish. Container Station will download the latest image and create a new container using the settings and data from the previous one. This updates the agent to the latest version while preserving all existing settings and data.
The only way to update an agent installed in a container is to remove the existing version and install a new one. Creating a new container requires reactivating the device, so you will need to reassign it to all backup plans.
Update process
Log in to XMS.
Go to the Devices tab and find the Docker agent.
Click the device details ℹ️ button. Review the Docker agent plans and note them, as you will need to add them again. All plans can be viewed in the Backup plans section; expand the list by clicking Load more.
Remove the old Xopero ONE agent container — in Container Station, click the Remove icon in the Actions tab to delete the container.
Once the old container has been removed, install the Xopero ONE agent Docker image again. Then, add the agent to all the plans it was previously assigned to.
Update process
When using the
:latesttag, the Container Manager monitors the image for updates. When a new version is detected, the Image tab will show the status Update available. Click the status to start the update process.
If the Update available button does not appear even when the agent update is available for other devices, you may wait up to 12 hours before it becomes visible.
When activated, a system prompt will indicate that the services and container will be temporarily suspended during the update. Confirm by clicking the Update button.
You will be prompted to confirm the update again by clicking the Update button.
The update progress will appear in the list of operations. Once the image is successfully downloaded, containers set to auto-start will restart automatically.
To verify the update, go to the Containers tab to check that the container is functioning correctly. Also, check if the system shows the latest version in Xopero ONE Management Service.
Last updated