> 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/updates/xopero-one-agent/update-on-linux-and-macos.md).

# Update on Linux & macOS

#### Regular updates of Xopero ONE agents on macOS and Linux help maintain system stability and protection.

***

## Update process

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

## Installer download

1. Log into **Xopero ONE Management Service** using a web browser to download the installer with the newest **agent** version. Then, go to the **Devices** tab and click the **Add device** button.

<figure><img src="/files/bhx3MQIeA8xZEYJN6qcw" alt="Downloading Xopero ONE Agent installer" width="493"><figcaption></figcaption></figure>

2. Select **Linux** from the list of available environments.

<figure><img src="/files/QRmzS54gPZBSmtW6B0pQ" alt="" width="362"><figcaption></figcaption></figure>

3. After selecting the version, the download will start automatically. You will also be redirected to the **Installation** view, which provides short step-by-step instructions for installing the software.

{% hint style="info" %}
You can transfer this file to the server or copy its link and download it directly on your **Linux** server using, for example, the `wget` command.
{% endhint %}

***

## Installation process

1. If the installer file is already downloaded, grant execute permission to the file’s owner or group. To do this, use the `chmod` command:

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

<figure><img src="/files/fWBlaBSSqtp4yqvrWb0F" alt="granding the permissions"><figcaption></figcaption></figure>

2. Run the script using one of the following commands:

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

```bash
bash xoperoclient.sh
```

{% hint style="danger" %}
The script must be run with administrative privileges, as it may require using the `sudo` command.
{% endhint %}

3. The installer will display the **End-User License Agreement**, which must be accepted to continue.

<figure><img src="/files/TG7OXyU7SdVaYbxm2Qsk" alt="EULA"><figcaption></figcaption></figure>

4. Confirm keeping the existing database.

<figure><img src="/files/rVs1gkiIlogtwbgj4g2l" alt="keep old database"><figcaption></figcaption></figure>

5. Confirm keeping the old configuration.

<figure><img src="/files/2LVY8vLqfpGxur81RwJj" alt="keep old configuration"><figcaption></figcaption></figure>

6. The **Xopero ONE agent** for **Linux** is now successfully updated.
   {% endtab %}

{% tab title="MacOS" %}

## Installer download

1. Log into **Xopero ONE Management Service** using a web browser to download the installer with the newest **agent** version. Then, go to the **Devices** tab and click the **Add device** button.

<figure><img src="/files/bhx3MQIeA8xZEYJN6qcw" alt="Xopero ONE Agent" width="493"><figcaption></figcaption></figure>

2. Select **macOS** from the list of available environments.

<figure><img src="/files/XOhXUFroH9xlvFa8GdZF" alt="" width="362"><figcaption></figcaption></figure>

3. After selecting the version, the download will start automatically. You will also be redirected to the **Installation** view, which provides short step-by-step instructions for installing the software.

***

## Installation process

1. Run the downloaded installer.
2. Click the **Continue** button in the **Introduction** section.

<figure><img src="/files/7FmNnExuLzpWGXzrfi4C" alt="" width="563"><figcaption></figcaption></figure>

3. Click the **Continue** button in the **Read Me** section.

<figure><img src="/files/oUm2Rp3OjgXuqlWGspX0" alt="" width="563"><figcaption></figcaption></figure>

4. Read the **End-User License Agreement** and click the **Continue**.

<figure><img src="/files/tLfmnmSaipQ9uDU6CtM9" alt="" width="563"><figcaption></figcaption></figure>

5. Click the **Agree** button to accept the **End-User License Agreement**.

<figure><img src="/files/DZfyeGmr6EdzAeLaEs0m" alt="" width="563"><figcaption></figcaption></figure>

6. Change the installation location if needed, or click the **Install** button to proceed with the default location.

<figure><img src="/files/xAmm7Rwn3zZ9krmc6fJF" alt="" width="563"><figcaption></figcaption></figure>

7. During the update process, the installer will prompt you for the IP address of your **Management Service** (refer to **step 3** in [**Installer download**](#installer-download-1) section above). Define it in this step.

<figure><img src="/files/oYxRu5HJO10n7BF33s23" alt="" width="489"><figcaption></figcaption></figure>

8. Confirm the configuration by clicking the **OK** button.

<figure><img src="/files/38x0ZzERCUbNLGTFwd9G" alt="" width="296"><figcaption></figcaption></figure>

9. Click **Close** to finish the installation. The **Xopero ONE agent** for **macOS** is now successfully updated.

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