# 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 %}


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://helpcenter.xopero.com/xopero-one-en/updates/xopero-one-agent/update-on-linux-and-macos.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.
