All pages
Powered by GitBook
1 of 1

Loading...

Installation within a Docker container

Agent service image is hosted on .

Deployment

  1. To install the Xopero ONE agent within a Docker container, use the images available on Docker Hub:

docker pull xopero/xone-agent:latest
  1. Create a host directory for the Xopero ONE service container databases (which are located at /app/Xopero inside the container) to store databases outside the container:

mkdir -p /opt/xone-agent/data
  1. Run the container with the correct volume mounting and environment variables using the following command:

  1. Check if the container works correctly by using the following command:

  1. Once all the above steps are completed, the agent will report to the Xopero ONE Management Service panel for activation.

QNAP with:

  • x86 or x64 CPU (ARM is not supported)

  • minimum 2GB RAM

  • Container Station app from AppCenter


QNAP with:

  • x86 or x64 CPU (ARM is not supported)

  • minimum 2GB RAM

  • Container Station app from AppCenter


  1. Navigate to the Container tab and click the Create button. Expand the Image section and click Add image, then search for xopero/xone-agent image.

  1. Select the image, click Download, and choose the version tagged as latest. Click Select to confirm.

  1. Download the Container Station app from the App Center.

  2. Login to your QNAP web panel and open the AppCenter application. In QNAP Store, select All Apps and search for the Container Station.

  1. Download and open the application. Select the path that will be used as a directory for your Docker container data, and click Start Now to proceed.


  1. Open the Container Station application, select the Containers tab, and click the Create button.

  1. In Image Configuration choose the Advanced mode option. In the image type, select Docker image, and in the Image field, paste the following command:

  1. Ensure the Try pulling image from the registry before creating the container option is checked, and hit Next.

  1. Within the Configure Container tab, the form contains several fields, with the most crucial being:

Name — here you can set a custom name for the container

Restart policy — defines if the container will star automatically in case of, for example, QNAP restart

  1. In the Configure Container tab, navigate to ⚙️Advanced Settings.

  2. Go to the Environments section and click Add New Variable to add new environment variables with the following values:

‼️*ManagementServiceUrl – your Xopero ONE Management Service (XMS) address in one of the following formats (depending on the XMS deployment model):

  1. http://ipaddress:port, i.e., http://192.168.0.1:28555

  2. https://XMSID.ads.xopero.com, i.e., https://a00b0dc0-0116-0000-0000-d0000028960e.ads.xopero.com

  1. Click Apply to save your changes.

  2. Navigate to Storage tab—here you can mount your QNAP volumes to the Xopero ONE agent docker container.

  1. Next, double-check and confirm your settings, then click Finish to create the container.

  1. Container Station will download the latest Xopero ONE image and create the container based on that image.

  1. Once the container creation process is completed, your new container will be visible under Container tab in Container Station.

  1. You can now connect to your Xopero ONE Management Service admin panel to activate the agent.

  1. Download the Container Station app from the AppCenter.

  2. Login to your QNAP web panel and open the AppCenter application. In QNAP Store, select All Apps and search for the Container Station.

  1. Download and open the application. Select the path that will be used as a directory for your Docker container data, and click Start Now to proceed.

  2. Once done, download the Xopero ONE agent Docker image, which is available here.


  1. Open the Container Station application and navigate the Import tab.

  2. Click the ➕Import button to upload the previously downloaded Docker image file.

  1. In Create Import Task window, select the source type and file path of the Xopero ONE agent Docker image and hit Next to continue.

  1. Within the Create Container tab, the form contains several fields, with the most crucial being:

Name — here you can set a custom name for the container

Auto start — defines if the container will star automatically in case of, for example, QNAP restart

CPU Limit — allows you to specify the percentage of CPU usage allocated for the container

Memory Limit — RAM limit for the container

  1. Click the ⚙️Advanced Settings >> button and navigate to the Environment section.

  1. To add a new environment variable, click the Add button, name it ManagementServiceUrl, and set its value to your Xopero ONE Management Service address*.

‼️*ManagementServiceUrl – your Xopero ONE Management Service (XMS) address in one of the following formats (depending on the XMS deployment model):

a. http://ipaddress:port, i.e., http://192.168.0.1:28555

b. https://XMSID.ads.xopero.com, i.e., https://a00b0dc0-0116-0000-0000-d0000028960e.ads.xopero.com

  1. Go to the Shared Folders section — here you can mount your QNAP volumes to the Xopero ONE agent Docker container.

  1. To back up data from your QNAP device, choose Add under Volume from host section— it lets you specify which data the Xopero ONE container can access. Select a directory from the host in Volume from host field and enter the path visible inside the container in the Mount Point field.

  1. Once you're done with the above steps, click Create to continue.

  2. In the Summary window double-check your settings, then click OK to finish the configuration.

  1. You can now connect to your Xopero ONE Management Service admin panel to activate the agent.

Once the image is downloaded, select it from the Image field drop-down menu.
  • Next, define a custom name for the container. Additionally, configure container resource limits if needed.

  • Check the Enable auto-restart option to ensure the container automatically restarts when the device reboots, then click Next to proceed.

    1. In the Volume Settings section, click the ➕Add Folder button, and select directories that require protection. The container needs to have external directories mounted to access them while performing backups.

    1. Additionally, to ensure data persistence during container updates or maintenance operations, mount agent databases to an external directory. These databases are located in /app/Xopero and should be mapped to a designated location outside the container to avoid data loss or inconsistency.

    1. Next, in the Environment section, define the required variables:

    ManagementServiceUrl — your Xopero ONE Management Service (XMS) address in one of the following formats (depending on the XMS deployment model):

    a. http://ipaddress:port, i.e., http://192.168.0.1:28555

    b. https://XMSID.ads.xopero.com, i.e., https://a00b0dc0-0116-0000-0000-d0000028960e.ads.xopero.com

    XoperoOverriddenHostName — specify agent's name to facilitate identification

    1. Click Next to confirm the configuration. In Summary window, double-check your settings and if they're all correct, hit Done to finalize the process.

    docker ps

    Prerequisites

    Prerequisites

    Deployment

    To deploy the Xopero ONE agent on a Synology device using Docker, use the Container Manager application. If it's not installed, download it from the Package Center.

    All Xopero service images are hosted on Docker Hub.

    circle-1Prerequisites
    circle-2Environment setup
    circle-3Deployment
    circle-1Prerequisites
    circle-2Environment setup
    circle-3Deployment
    the official Xopero profile on Docker Hub
    docker run -v /host/path:/container/path -e ENV_VAR=value image_name
    docker run -d \
      --name <container_name> \
      -e ManagementServiceUrl="<your_xopero_one_service_URL>" \
      -e XoperoOverriddenHostName="<device_name>" \
      -v /opt/xone-agent/data:/app/Xopero \
      --restart unless-stopped \
      xopero/xone-agent:latest
    Example
    docker run -d \
      --name xone-agent \
      -e ManagementServiceUrl="https://192.168.1.10:28555" \
      -e XoperoOverriddenHostName="Docker_agent" \
      -v /opt/xone-agent/data:/app/Xopero \
      --restart unless-stopped \
      xopero/xone-agent:latest
    xopero/xone-agent:latest
    ASPNETCORE_URLS
    http://+:80
    DOTNET_RUNNING_IN_CONTAINER
    true
    ManagementServiceUrl
    Xopero ONE Management Service address
    XoperoOverriddenHostName
    your custom QNAP container name

    Environment setup

    Deployment

    Replace Xopero ONE Management Service address with your Xopero ONE Management Service address*.

    You can mount multiple directories to the container using Add Volume button and repeating the operation.

    To back up data from your QNAP device, choose Bind Mount Host Path under Add Volume drop-down menu — it lets you specify which data the Xopero ONE container can access. Select a directory from the host and enter the path visible inside the container in the Container field.

    Environment setup

    Deployment

    Selecting a file from a local source enables you to choose files stored on your device. Alternatively, you can use the NAS option to access files directly from QNAP.

    You can mount multiple directories to the container using Add button in Volume from host section and repeating the operation.

    For instance, if you need to back up a directory named Backup inside a public shared folder, set the Volume from the host field to /Public/Backup. The Mount Point can be different, i.e., /Backup.

    To protect data stored in the Public directory, select this folder and specify the same path to ensure consistency between the host and the container's file systems.

    You can mount multiple directories to the container by clicking ➕ Add Folder and repeating the operation.

    create container
    Creating import task
    Creating container
    Importing the docker file
    Setting shared folders
    Summary window