> For the complete documentation index, see [llms.txt](https://helpcenter.gitprotect.io/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://helpcenter.gitprotect.io/updates/gitprotect-worker/update-on-linux-and-macos.md).

# Update on Linux & macOS

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

## Installer download

1. Log into **GitProtect Management Service** using a web browser to download the installer with the newest **worker** version. Click the **Activate agent** button in the left-top corner of the screen.

<figure><img src="https://696332517-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FtsE6XtJyUIEKVdSxPlS3%2Fuploads%2Fx6pl3WOCwMJ4b2JHjBHj%2Fimage.png?alt=media&amp;token=9922a49d-54d7-4266-bccd-0e287d7d4280" alt="Downloading Xopero ONE Agent installer"><figcaption></figcaption></figure>

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

<figure><img src="https://696332517-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FtsE6XtJyUIEKVdSxPlS3%2Fuploads%2FM6L4xnMulwwiVnraiUhg%2Fimage.png?alt=media&amp;token=abb0b197-f7dc-4433-a3c2-7ef048a89ec6" alt=""><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://696332517-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FtsE6XtJyUIEKVdSxPlS3%2Fuploads%2FGkRAZPIQqS0B2KVljg3G%2Fgranding%20the%20permissions.png?alt=media&amp;token=beff1cc9-8959-4c48-8639-927a4dceee18" 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://696332517-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FtsE6XtJyUIEKVdSxPlS3%2Fuploads%2FzmEsXqFWjW6MX1UEEOiN%2FEULA.png?alt=media&amp;token=bc5a6189-90a1-47a0-94fd-65ccd923bdd7" alt="EULA"><figcaption></figcaption></figure>

4. Confirm keeping the existing database.

<figure><img src="https://696332517-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FtsE6XtJyUIEKVdSxPlS3%2Fuploads%2FQWDLFC7vfb4dBKHyekiN%2Fkeep%20old%20database.png?alt=media&amp;token=2d749b8a-1993-4a64-a57c-04d6e726917c" alt="keep old database"><figcaption></figcaption></figure>

5. Confirm keeping the old configuration.

<figure><img src="https://696332517-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FtsE6XtJyUIEKVdSxPlS3%2Fuploads%2Fx3t0A4VL7CMZOy9ISJmu%2Fkeep%20old%20configuration.png?alt=media&amp;token=255c299b-c79b-42a5-978d-852a6e96a8dd" alt="keep old configuration"><figcaption></figcaption></figure>

6. The **GitProtect worker** for **Linux** is now successfully updated.
   {% endtab %}

{% tab title="MacOS" %}

## Installer download <a href="#installer-download-1" id="installer-download-1"></a>

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

<figure><img src="https://696332517-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FtsE6XtJyUIEKVdSxPlS3%2Fuploads%2Fx6pl3WOCwMJ4b2JHjBHj%2Fimage.png?alt=media&amp;token=9922a49d-54d7-4266-bccd-0e287d7d4280" alt=""><figcaption></figcaption></figure>

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

<figure><img src="https://696332517-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FtsE6XtJyUIEKVdSxPlS3%2Fuploads%2FM6L4xnMulwwiVnraiUhg%2Fimage.png?alt=media&amp;token=abb0b197-f7dc-4433-a3c2-7ef048a89ec6" alt=""><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://696332517-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FtsE6XtJyUIEKVdSxPlS3%2Fuploads%2FVEceKMwYFtp8BRGcm7al%2Fimage.png?alt=media&amp;token=23a90dcd-d80f-4b08-baea-d28167a255f2" alt="" width="563"><figcaption></figcaption></figure>

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

<figure><img src="https://696332517-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FtsE6XtJyUIEKVdSxPlS3%2Fuploads%2FsEnUl6hpMoakYyCXzG4m%2Fagentmac3.png?alt=media&amp;token=c05c5154-6a48-49fd-85d6-89ec7758225b" alt="" width="563"><figcaption></figcaption></figure>

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

<figure><img src="https://696332517-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FtsE6XtJyUIEKVdSxPlS3%2Fuploads%2FGZ66XNMX0ElBvZi08Tzt%2Fagentmac4.png?alt=media&amp;token=c7134c25-1456-499a-92cc-0647b0696f81" alt="" width="563"><figcaption></figcaption></figure>

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

<figure><img src="https://696332517-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FtsE6XtJyUIEKVdSxPlS3%2Fuploads%2Fz0vNOh4iemN73OCrwP9g%2Fagentmac5.png?alt=media&amp;token=35ba0ac8-292c-4c1f-aac4-9f4d9a682d19" 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://696332517-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FtsE6XtJyUIEKVdSxPlS3%2Fuploads%2FT51pl7WLls5EPoVVqzL5%2Fimage.png?alt=media&amp;token=8936ba9c-8d6d-4055-ac0c-2993c2759a2c" 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**](https://app.gitbook.com/o/EOMm1MEqvgMWkvjFfyqF/s/0CBTl43C3OO6ySL1DJ6k/updates/xopero-one-agent/update-on-linux-and-macos#installer-download-1) section above). Define it in this step.

<figure><img src="https://696332517-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FtsE6XtJyUIEKVdSxPlS3%2Fuploads%2FWZZ23hDgQMa8LvEHMXAJ%2Fimage.png?alt=media&amp;token=e2e3e629-672e-45e7-a366-15c89a1ec6f6" alt="" width="489"><figcaption></figcaption></figure>

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

<figure><img src="https://696332517-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FtsE6XtJyUIEKVdSxPlS3%2Fuploads%2F50WH7pfv57mszAyJRVfv%2Fimage.png?alt=media&amp;token=5fb7895e-1107-425c-93c0-48ccfb8400df" alt="" width="296"><figcaption></figcaption></figure>

8. Click **Close** to finish the installation. The **GitProtect worker** for **macOS** is now successfully updated.
   {% endtab %}
   {% endtabs %}