Update within a Docker container
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 GitProtect worker:
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>— GitProtect Management Service address with the port (i.e.,123.456.7.890:28555)<device_name>— custom Docker container name
Once done, the GitProtect worker 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 worker 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:
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 worker to the latest version while preserving all existing settings and data.
The only way to update a worker 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 GitProtect Management Service.
Find the Docker worker.
Click the device details ℹ️ button. Review the Docker worker 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 GitProtect worker 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 GitProtect agent Docker image again. Then, add the worker 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 worker 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 GitProtect Management Service.
Last updated