> 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="/files/ptB2i3f6b9ELBnVXihbB" alt="Downloading Xopero ONE Agent installer"><figcaption></figcaption></figure>

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

<figure><img src="/files/lsgMUhkWCjJecokNm1sp" 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="/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 **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="/files/ptB2i3f6b9ELBnVXihbB" alt=""><figcaption></figcaption></figure>

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

<figure><img src="/files/lsgMUhkWCjJecokNm1sp" 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="/files/dgCUzcCSpP1tGOK83oJZ" 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/eO5Zu4jLdvgM0OXJafeR" 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="/files/wy49uCf7Twyh3aeT0KeP" alt="" width="489"><figcaption></figcaption></figure>

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

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

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