> 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-agent/installation-on-linux-and-macos.md).

# Installation on Linux & MacOS

{% tabs %}
{% tab title="Linux" %}

<p align="center"><a href="#prerequisites" class="button primary" data-icon="circle-1">Prerequisites</a>    <a href="#agent_setup" class="button primary" data-icon="circle-2">Installation</a></p>

## Prerequisites

Prior to agent installation, check if your system is meets all the requirements.

{% content-ref url="/pages/sWnNuc32ePz2p4zZ0Rdz" %}
[System requirements](/xopero-one-en/xopero-one-software/software-information/system-requirements.md)
{% endcontent-ref %}

{% content-ref url="/pages/ZO1Ci3C1rUavK5WvO4ld" %}
[Supported platforms](/xopero-one-en/xopero-one-software/software-information/supported-platforms.md)
{% endcontent-ref %}

***

## Installation <a href="#agent_setup" id="agent_setup"></a>

1. Download the **agent** installer (bash script) to your **Linux** system and grant execute permission to the file owner (user or group) using the following `chmod` command:

{% hint style="info" %}
To download the agent installer, login to **Xopero ONE Management Service** using a web browser, then go to **Settings** > **Advanced** > **Workers** and click **Download agent** button. The **Download agent** window will open — click the appropriate agent version to download it.
{% endhint %}

```bash
chmod +x xoperoclient.sh
```

<figure><img src="/files/S4bWOUDLFrYgU2ucgrlW" alt="Granting permission for installer"><figcaption></figcaption></figure>

2. Next, run the script using the following command:

```bash
./xoperoclient.sh or bash xoperoclient.sh
```

<figure><img src="/files/Iulz1nYSMcfoWsemvXcE" alt="Running the installer"><figcaption><p><em>Running the script along with <strong><code>sudo</code></strong> command</em></p></figcaption></figure>

{% hint style="warning" %}
The above script should be initiated using an account with administrative privileges — because of that it might be required to use the **`sudo`** command simultaneously (as in the above example).
{% endhint %}

3. Accept the **END-USER LICENSE AGREEMENT** to proceed.

<figure><img src="/files/OeSPrfRBKiauZPSfJR0N" alt="End-user agreement"><figcaption></figcaption></figure>

4. Next, enter the IP address in the **Address** field (including the protocol and port) and click **OK** to finish the installation. Your address can be found in **Xopero ONE Management Service** — the system will display it once you start downloading the **agent** installer.

<figure><img src="/files/aSsLnvMXBuuDoCZM8UDG" alt="Xopero ONE service URL example"><figcaption></figcaption></figure>

5. Now that **Xopero ONE agent** is installed, you can activate it in the **Xopero ONE Management Service** (**XMS**) web panel and start protecting your data.
   {% endtab %}

{% tab title="MacOS" %}

<p align="center"><a href="#installation-mac" class="button primary" data-icon="circle-1">Installation</a>    <a href="#unattended-installation" class="button primary" data-icon="circle-2">Unattended installation</a>    <a href="#permissions-configuration" class="button primary" data-icon="circle-3">Permissions configuration</a></p>

## Installation <a href="#installation-mac" id="installation-mac"></a>

1. Download **Xopero ONE agent** installation wizard via XMS[^1] and run it.

{% hint style="info" %}
To download the **agent** installer, login to **Xopero ONE Management Service** using a web browser, then go to **Settings** > **Advanced** > **Workers** and click **Download agent** button. The **Download agent** window will open — click the appropriate **agent** version to download it.
{% endhint %}

2. Click **Continue** to proceed.

<figure><img src="/files/SnFr4lkOqoVEsuSU1Ibx" alt=""><figcaption></figcaption></figure>

3. Select **Continue** in the **Read Me** section.

<figure><img src="/files/jkitdX49xJ10aY8v46UO" alt=""><figcaption></figcaption></figure>

4. Read the **END-USER LICENSE AGREEMENT** and hit **Continue** to accept it.

<figure><img src="/files/olfwJtFYFDYvGG19VFCa" alt=""><figcaption></figcaption></figure>

5. Hit **Agree** to accept the terms of the software license agreement.

<figure><img src="/files/GJn9cC8tonjU4DRR7GxF" alt=""><figcaption></figcaption></figure>

6. Change the installation directory if needed and click **Install** to begin the installation.

<figure><img src="/files/TRNgvOhefGxy2leX25Dl" alt=""><figcaption></figcaption></figure>

7. During the installation process, the creator will ask you for the address of your XMS[^1]— define it in this step.

<figure><img src="/files/WQqJqCE5kex7M9qDPr7b" alt=""><figcaption></figcaption></figure>

8. Click **OK** to confirm your configuration.
9. The **Xopero ONE** agent has been successfully installed— you can close the installation wizard.

<figure><img src="/files/BM0Fn1SsBNbUZ59vMpip" alt=""><figcaption></figcaption></figure>

***

## Unattended installation

If you don't want to use the installation wizard, you can choose the unattended installation option.

1. Download the `xoperoclient.pkg` file to your device.

{% hint style="info" %}
To download the **agent** installer, login to **Xopero ONE Management Service** using a web browser, then go to **Settings** > **Advanced** > **Workers** and click **Download agent** button. The **Download agent** window will open — click the appropriate **agent** version to download it.
{% endhint %}

2. Run the following command in **macOS** terminal (**Applications** > **Utilities** > **Terminal**):

{% code overflow="wrap" %}

```bash
sudo /bin/launchctl setenv "XOPERO_INSTALLER_SERVER_ADDRESS_CONFIG" "https://XMS_adress::28555>" && sudo installer -pkg <pkg_file_location> -target /; sudo /bin/launchctl unsetenv "XOPERO_INSTALLER_SERVER_ADDRESS_CONFIG"
```

{% endcode %}

> **‼️Command overview:**
>
> {% code title="Setting the environment variable with your Xopero ONE Management Service IP address and default port" overflow="wrap" %}
>
> ```bash
> sudo /bin/launchctl setenv "XOPERO_INSTALLER_SERVER_ADDRESS_CONFIG" "https://<XMS_adress::28555>"
> ```
>
> {% endcode %}
>
> {% code title="Launching the installer" overflow="wrap" %}
>
> ```bash
> sudo installer -pkg <pkg_file_location> -target /;
> ```
>
> {% endcode %}
>
> {% code title="Removing environment variables" overflow="wrap" %}
>
> ```bash
> sudo /bin/launchctl unsetenv "XOPERO_INSTALLER_SERVER_ADDRESS_CONFIG"
> ```
>
> {% endcode %}

***

## Permissions configuration

After installation, in a few steps you need to add the necessary permissions for the **Xopero** file.

1. Click on the **Mac** icon in the upper left corner and select **System Preferences...** from the drop-down menu.

<figure><img src="/files/0yAHZg21Jt3GYJPfd1Tt" alt=""><figcaption></figcaption></figure>

2. Next, go to **Security & Privacy**.

<figure><img src="/files/il6QshJ6YkU5WXMNC1Mx" alt="" width="517"><figcaption></figcaption></figure>

3. Navigate to the **Privacy** tab, then select **Full Disk Access** from the menu on the left.

<figure><img src="/files/gA0BTrv0amXFR3UdqpyM" alt="" width="515"><figcaption></figcaption></figure>

4. Add **Xopero.Device.App.app** to the list.

<figure><img src="/files/cQhfGFA6OsHhWAQhlxQg" alt=""><figcaption></figcaption></figure>

5. Grant access to **Xopero.Device.App.app** to finish the configuration.

<figure><img src="/files/ySqF5rHAaDfHqE9MywoQ" alt="" width="563"><figcaption></figcaption></figure>
{% endtab %}
{% endtabs %}

To learn how to activate the agent in the Xopero management console, check the *Useful links and items* section.

## Useful links and items

{% content-ref url="/pages/sUUV69SpYVc3DM8CFnms" %}
[Agent configuration](/xopero-one-en/deployment-and-configuration/xopero-one-agent/agent-configuration.md)
{% endcontent-ref %}

[^1]: Xopero ONE Management Service