> For the complete documentation index, see [llms.txt](https://helpcenter.xopero.com/xopero-one-en/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://helpcenter.xopero.com/xopero-one-en/deployment-and-configuration/xopero-one-management-service-xms/installation-on-windows-and-linux.md).

# Installation on Windows & Linux

This article describes the process of Xopero ONE Management Service installation on Windows, Linux, and as a Docker container for on-premise deployment model.

{% hint style="warning" %}
Before you begin the installation process, check the following articles: [System requirements](/xopero-one-en/xopero-one/system-requirements.md), [Supported platforms](/xopero-one-en/xopero-one/supported-platforms.md).
{% endhint %}

{% hint style="success" %}
To register for a free trial and download the installer visit the [**Xopero** website](https://xopero.com/). If you're already a registered user, download the installer [here](https://xopero.com/latest-updates/).
{% endhint %}

{% tabs fullWidth="false" %}
{% tab title="Windows" %}

## Installation process for Windows

1. Download and run **Xopero ONE** installer.

<figure><img src="https://319733277-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F0CBTl43C3OO6ySL1DJ6k%2Fuploads%2Foh9vdZubb93oy8WUKWJJ%2Fimage.png?alt=media&amp;token=421cc859-b620-4ffb-a470-f691b182d9a3" alt="" width="563"><figcaption></figcaption></figure>

2. Click **Next** to start the installation setup.

<figure><img src="https://319733277-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F0CBTl43C3OO6ySL1DJ6k%2Fuploads%2FBothmd6c5PXZ3vdCMR8z%2Fimage.png?alt=media&amp;token=3dd286b5-69fe-4d2d-b83b-870ffe106b7b" alt=""><figcaption></figcaption></figure>

3. Accept the **End-User License Agreement** and hit **Next** to continue.

<figure><img src="https://319733277-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F0CBTl43C3OO6ySL1DJ6k%2Fuploads%2FBINv3LyyDlFeYgE5Z5Vz%2Fimage.png?alt=media&amp;token=87de7bd5-e5e5-43d7-aab6-2de602a57bfd" alt=""><figcaption></figcaption></figure>

4. Select the installation folder and click **Next**.

<figure><img src="https://319733277-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F0CBTl43C3OO6ySL1DJ6k%2Fuploads%2Fxk1TqLRO3Z8Grrjsaozo%2Fimage.png?alt=media&amp;token=82221b67-6783-4adc-9ab1-6fcc9a997670" alt=""><figcaption></figcaption></figure>

5. Define the HTTP port for **Xopero ONE Management Service**. Depending on your needs you can either use a custom HTTP port, or stay with the default **XMS** HTTP port (28555).

<figure><img src="https://319733277-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F0CBTl43C3OO6ySL1DJ6k%2Fuploads%2FJ1S8gcy2uGxqITqgQktP%2Fimage.png?alt=media&amp;token=4696f4d1-c6fc-4e58-97ef-9fc79cd59018" alt=""><figcaption></figcaption></figure>

6. Click **Install** to start the installation process.

<figure><img src="https://319733277-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F0CBTl43C3OO6ySL1DJ6k%2Fuploads%2Fni2uRlNzxBJqc2oJrtOd%2Fimage.png?alt=media&amp;token=69980d48-58d6-4ea9-af9b-8af7150311e1" alt=""><figcaption></figcaption></figure>

7. Once the installation is completed successfully, click **Finish** to close the installation wizard.
   {% endtab %}

{% tab title="Linux" %}

## Installation process for Linux

1. Download and run **Xopero ONE** installer (`XoperoONEManagementService.sh`).

<figure><img src="https://content.gitbook.com/content/0CBTl43C3OO6ySL1DJ6k/blobs/l2nlLUpe1fL19KgqDyct/image.png" alt="Downloading xoperoserver.sh"><figcaption></figcaption></figure>

2. Add `execute` permission to the downloaded file using the following command:

```bash
chmod +x xoperoserver.sh
```

<figure><img src="https://content.gitbook.com/content/0CBTl43C3OO6ySL1DJ6k/blobs/zyqzJ5nU1bANDodacU6L/image.png" alt="Adding execute permission"><figcaption></figcaption></figure>

3. Run `xoperoserver.sh`. Accept the **End-User License Agreement** to continue.

<figure><img src="https://content.gitbook.com/content/0CBTl43C3OO6ySL1DJ6k/blobs/0KXuoXhyrpNM4ydiwBzS/image.png" alt="End-user license agreement"><figcaption></figcaption></figure>

4. Once the installation is completed, you can close the software installation window.

{% hint style="warning" %}
Please note that, by default, the **Xopero ONE Management Service** installed on **Linux** uses port 28555.
{% endhint %}

<figure><img src="https://content.gitbook.com/content/0CBTl43C3OO6ySL1DJ6k/blobs/sM3yGeCRky8XAA2nDcHy/image.png" alt="Finished installation window"><figcaption></figcaption></figure>
{% endtab %}
{% endtabs %}
