# 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="https://319733277-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F0CBTl43C3OO6ySL1DJ6k%2Fuploads%2F9pIOMn4wEPzKtV4XR4Xm%2Fimage.png?alt=media&#x26;token=4a889e8c-72f1-4d48-8821-10a66d719249" alt="Downloading Xopero ONE Agent installer" width="493"><figcaption></figcaption></figure>

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

<figure><img src="https://319733277-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F0CBTl43C3OO6ySL1DJ6k%2Fuploads%2FUMGO4RanM8aJRpHCQQfQ%2Fimage.png?alt=media&#x26;token=050ce397-192f-4572-8327-61123cca4c89" 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="https://content.gitbook.com/content/0CBTl43C3OO6ySL1DJ6k/blobs/tyYnAndsDHtHwByl8GfT/granding%20the%20permissions.png" 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="https://content.gitbook.com/content/0CBTl43C3OO6ySL1DJ6k/blobs/bpCcycT1uzbHML0fa8pv/EULA.png" alt="EULA"><figcaption></figcaption></figure>

4. Confirm keeping the existing database.

<figure><img src="https://content.gitbook.com/content/0CBTl43C3OO6ySL1DJ6k/blobs/TxytobznQ5jJTGFLfZDf/keep%20old%20database.png" alt="keep old database"><figcaption></figcaption></figure>

5. Confirm keeping the old configuration.

<figure><img src="https://content.gitbook.com/content/0CBTl43C3OO6ySL1DJ6k/blobs/1JQJ9cJYgwt3zD3IlLsI/keep%20old%20configuration.png" 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="https://319733277-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F0CBTl43C3OO6ySL1DJ6k%2Fuploads%2F9pIOMn4wEPzKtV4XR4Xm%2Fimage.png?alt=media&#x26;token=4a889e8c-72f1-4d48-8821-10a66d719249" alt="Xopero ONE Agent" width="493"><figcaption></figcaption></figure>

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

<figure><img src="https://319733277-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F0CBTl43C3OO6ySL1DJ6k%2Fuploads%2FpSA7gbYpob6fDEzvrFKx%2Fimage.png?alt=media&#x26;token=f252bb95-a5ee-4f95-a249-094455e8e57a" 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="https://319733277-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F0CBTl43C3OO6ySL1DJ6k%2Fuploads%2FTvv1ogSiqVysbH0uHTSd%2Fimage.png?alt=media&#x26;token=dd37dc74-2bbf-435b-887c-c79ffe2b7a57" alt="" width="563"><figcaption></figcaption></figure>

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

<figure><img src="https://319733277-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F0CBTl43C3OO6ySL1DJ6k%2Fuploads%2Fj7Df1Vce9FxX4FHoO9DH%2Fimage.png?alt=media&#x26;token=c1122a9a-145e-4f15-88c4-31df47f99bb5" alt="" width="563"><figcaption></figcaption></figure>

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

<figure><img src="https://319733277-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F0CBTl43C3OO6ySL1DJ6k%2Fuploads%2F1bRIIadsd9vvgOKUGXT0%2Fimage.png?alt=media&#x26;token=ecb73d0d-ae59-4027-ae37-8bb7c820822c" alt="" width="563"><figcaption></figcaption></figure>

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

<figure><img src="https://319733277-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F0CBTl43C3OO6ySL1DJ6k%2Fuploads%2FhoGsYjpqQoMfr2UWepVm%2Fimage.png?alt=media&#x26;token=16e33d77-af4b-4151-8b23-87973bdf0d4f" 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="https://319733277-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F0CBTl43C3OO6ySL1DJ6k%2Fuploads%2FOJK2apoyVLjSbNYSnJOb%2Fimage.png?alt=media&#x26;token=5712b791-ad61-4c89-a99e-fb950d2de1f1" 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="https://319733277-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F0CBTl43C3OO6ySL1DJ6k%2Fuploads%2FEsjJd71Ame2shPRW7Lq5%2Fimage.png?alt=media&#x26;token=42322361-7a01-421f-a5d6-e764c0f6f0d9" alt="" width="489"><figcaption></figcaption></figure>

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

<figure><img src="https://319733277-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F0CBTl43C3OO6ySL1DJ6k%2Fuploads%2F0aHmxjAR5bl6RALb17oW%2Fimage.png?alt=media&#x26;token=ce91f86a-3ffb-412a-aa2d-ab6c93c0f7f5" 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="https://319733277-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F0CBTl43C3OO6ySL1DJ6k%2Fuploads%2FmDd7hUYM86oMSu8pcbiF%2Fimage.png?alt=media&#x26;token=cc629b6b-70a8-43af-adb1-1164be7864aa" alt="" width="563"><figcaption></figcaption></figure>
{% endtab %}
{% endtabs %}