# Installation within a Docker container {% tabs %} {% tab title="Docker Desktop (manual)" %} ### Deployment 1. Download the **GitProtect Management Service** [**Docker** image](https://xopero.com/download/xopero_one/latest/management-image.tar) to your device. Open **cmd** console and pull **Management Service** **Docker** image using the following command: ```docker docker load -i .tar ``` {% hint style="danger" %} Replace `.tar` with the name of your **Management Service Docker** image file. {% endhint %} 2. Once the **Docker** image is imported, use the following command to create a container: ```docker docker run -d \ --name \ -p :80 \ -v :/app/Xopero \ xopero/xopero-one-service ``` {% hint style="warning" %} In the above command, replace **drive\_location\_database** with the location to mount the database on (from the container to the local directory) — **this is important for upgrading the container later**. In place of **container\_name**, enter the name of your container and in place of **service\_port**, enter the service port which will be used by **GitProtect** (by default, **Management Service** port is set to 28555). {% endhint %} {% code title="Example:" overflow="wrap" %} ```docker docker run -d \ --name xone \ -p 28555:80 \ -v C:\database_docker\xone:/app/Xopero \ xopero/xopero-one-service ``` {% endcode %}
3. Next, use the following command to view the list of containers (or view the list in **Docker Desktop**): ```docker docker ps -a ```
viewing the container list
Docker GUI
4. If you see no errors, that means the **Management Service** implementation was done correctly. You can open the **GitProtect Management Service** web panel using the following address: ```http http://:28555 ``` 5. Before you start using **Management Service** you must create an administrator account and assign a license to your unit. {% endtab %} {% tab title="QNAP NAS (Container Station > 3.0)" %}

Prerequisites Environment setup Deployment

### Prerequisites **QNAP** with: * x86 or x64 CPU (ARM is **not supported**) * minimum 2GB of RAM * **Container Station** app from the **App Center** *** ### Environment setup 1. Login to your **QNAP** web panel and open the **App Center** application. Go to **QNAP Store** > **All Apps** and search for **Container Station**.
Selecting Container Station
2. Download the **Container Station** application. Once downloaded, open the app and select the path you'll be using as your **Docker** container data directory. 3. Click **Start Now** to proceed. *** ### Deployment 1. In the **Container Station** application, open the **Containers** menu option, and click the **Create** button.
2. In **Image Configuration**, choose **Advanced mode**. For **Image type** select **Docker image**, and in the **Image** field, paste the following: ```docker xopero/gitprotect-service:latest ``` 3. Ensure **Try pulling the image from the registry before creating the container.** checkbox is checked, then hit **Next**.
4. In the **Configure Container** tab, configure the **GitProtect Docker** container and hit **Next** to continue. > **Name** — set a custom name for the container > > **Auto start** — defines if the container should startup automatically (i.e., in case of **QNAP** restart) > > **Publish network ports** — enter a port number in the **Host** field— this will be the port used to connect to **GitProtect** service on the container on port 80 (the recommended host port number is 28555)
5. Double-check your configuration settings and hit **Finish**. 6. **Container Station** will download the latest **GitProtect** image and create the container based on it.
7. Once the container creation process is completed, your new container will be available in the **Container Station** application (under **Containers** menu option).
8. Connect to **GitProtect** using your web URL address in the following format (you can find it under **Container Details** > **General** > **Web URL**): > `http://:` 9. To finish the **XMS** setup, create a new administrative account, provide the license code, and select data to protect. {% endtab %} {% tab title="QNAP NAS (Container Station < 3.0)" %}

Prerequisites Environment setup Deployment

### Prerequisites **QNAP** with: * [x] x86 or x64 CPU (ARM is **not supported**) * [x] minimum 2GB of RAM * [x] **Container Station** app from the **App Center** *** ### Environment setup 1. Login to your **QNAP** web panel and open the **App Center** application. Go to **QNAP Store** > **All Apps** and search for **Container Station**.
Selecting Container Station
2. Download the **Container Station** application. Once downloaded, open the app and select the path you'll be using as your **Docker** container data directory. 3. Click **Start Now** to proceed. *** ### Deployment 1. Open the **Container Station** application and click ➕ **Create** in the left-hand side menu. 2. Copy and paste `xopero/gitprotect-service` in the search field and hit **Enter** to search for the **Management Service Docker** image (it should be the first search result in **Docker Hub** tab). 3. Click the **Install** button next to the **Docker** image to start the container creation process. 4. Select the latest image version and click **Next** to continue.
Selecting GitProtect version
5. In the **Create Container** window, configure the **GitProtect Docker** container. > **Name** — set a custom name for the container > > **Auto start** — defines if the container should startup automatically (i.e., in case of **QNAP** restart) > > **CPU Limit** — allows you to set the CPU percentage usage available for the container > > **Memory Limit** — RAM memory allocated to the container 6. Scroll down a little and click the ⚙️ **Advanced Settings>>** 7. In the ⚙️ **Advanced Settings>>** go to **Network** and click the **Add** button on the right. Enter a port number in the **Host** field under the **Port Forwarding** section— this will be the port used to connect to **GitProtect** service (the recommended, default port number is **28555**).
Creating contener - network tab
8. Click the **Create** button— this will display the setup summary. Double-check your configuration and click **OK** to create the container. 9. Once the container creation process is completed, your new container will be available in the **Container Station** application (under **Container** menu option).
View on running container with GitProtect
10. Connect to **GitProtect Management Service** by launching it via **Container Station**, or using your web URL address in the following format: > `http://:` 11. To finish the **Management Service** setup, create a new administrative account, provide the license code, and select data to protect. {% endtab %} {% tab title="Synology NAS (Docker Hub)" %}

Prerequisites Deployment

### Prerequisites **Synology** must meet the following requirements: * [x] x86 or x64 CPU (ARM is **not supported**) * [x] minimum 2 GB of RAM * [x] **Docker** app from the **Package Center** *** ### Deployment 1. Open the **Docker Hub**, navigate to the **Container** menu, and click **Create** button. 2. Expand the **Image** section and select **Add image**. Then, search for `xopero/gitprotect-service`. Once located, select the image, click **Download**, and choose the version tagged as **latest**. Confirm the selection to proceed.
3. Once you download the image, select it from the **Image** drop-down menu in **General Settings**. Next, define a name for the container and enter it in the **Container Name** field. Configure container resource limits if necessary. 4. Check the **Enable auto-restart** checkbox to ensure the container automatically restarts when the device reboots, and proceed to the next step.
5. In **Volume Settings**, click ➕ **Add Folder** button. To ensure data persistence during container updates or maintenance operations, mount the management 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.
6. In the **Environment** section, define the required variables: > **ASPNETCORE\_URLS** — **Management Service** ports for http and https protocol (i.e., **http\://+:****PORT\_NUMBER****;https\://+:****PORT\_NUMBER**) {% hint style="warning" %} The management console is available on port **28555** for the encrypted protocol (**https**), and on port **28556** for the unencrypted (**http**) protocol. {% endhint %}
7. Select **host** from the **Network** drop-down menu to enable the container to share the same network namespace as the container's host.
8. Confirm the configuration and click **Next**. In **Summary**, double-check the settings and hit **Done** to finish the container creation process.
9. Once you've created the container, you can connect to your **XMS** using one of the following addresses: > https\://**yourSynologyAddress**:28555 (i.e., https\://**192.168.0.100**:28555) > > http\://**yourSynologyAddress**:28556 (i.e., http\://**192.168.0.100**:28556) > {% endtab %} > {% endtabs %}