Running Xopero ONE Agent On Synology NAS
This article describes how to install and configure Xopero ONE agent application running as a docker container on Synology NAS.
Last updated
This article describes how to install and configure Xopero ONE agent application running as a docker container on Synology NAS.
Last updated
To deploy Xopero ONE Agent as a Docker container on a Synology device, utilize the Container Manager application. If this application is not already installed, it can be obtained through the Package Center.
Navigate to the Container tab and click the Create button. To properly initialize a container, an image is required. All Xopero service images are hosted on Docker Hub. Expand the Image section and select Add image from the list at the bottom. Then, search for the "xopero/gitprotect-agent" image.
Once located, select the image, click Download, and choose the version tagged as "latest". Confirm the selection by clicking the Select button. After the image has been downloaded, specify it in the Image field. Next, define a name for the container running the backup agent. Additionally, configure container resource limits if necessary. Enable the "Auto-restart" option to ensure the container automatically restarts when the device reboots. Proceed to the next step by clicking Next.
In the Volume Settings section, click the + Add Folder button and select the directories that require protection. The container must mount external directories to access them during the backup process. For instance, if the data to be protected is stored in the "Public" directory, select this folder and specify an identical path to ensure consistency between the host and the container’s file system.
For example, if you want to back up a directory named Public, select this folder and in the next field enter the /Public path.
You can mount multiple directories to the container by clicking + Add folder and repeating the operation.
Additionally, to ensure data persistence during container updates or maintenance operations, mount by + Add Folder the agent databases to an external directory. The databases are stored in /app/Xopero and should be mapped to a designated location outside the container to prevent data loss or inconsistencies.
In the Environment section, define the required variables:
ManagementServiceUrl – specify the URL of the management service (e.g., http://192.168.0.1:28555
or https://a00b0dc0-0116-0000-0000-d0000028960e.ads.xopero.com
).
XoperoOverriddenHostName – specify the agent name to facilitate identification.
Confirm the configuration by clicking Next. Finally, in the summary view, review all entered details for accuracy and finalize the process by clicking Done.