# Installation on Linux & MacOS

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

<p align="center"><a href="#prerequisites" class="button primary" data-icon="circle-1">Prerequisites</a> <a href="#agent_setup" class="button primary" data-icon="circle-2">Installation</a></p>

#### Prerequisites

Prior to **worker** installation, check if your system is meets all the requirements.

{% content-ref url="../../../gitprotect-software/software-information/system-requirements" %}
[system-requirements](https://helpcenter.gitprotect.io/gitprotect-software/software-information/system-requirements)
{% endcontent-ref %}

{% content-ref url="../../../gitprotect-software/software-information/supported-platforms" %}
[supported-platforms](https://helpcenter.gitprotect.io/gitprotect-software/software-information/supported-platforms)
{% endcontent-ref %}

***

#### Installation <a href="#agent_setup" id="agent_setup"></a>

1. Download the **worker** installer (bash script) to your **Linux** system and grant execute permission to the file owner (user or group) using the following `chmod` command:

{% hint style="info" %}
To download the worker installer, login to **GitProtect Management Service** using a web browser, then go to **Settings** > **Advanced** > **Workers** and click **Download agent** button. The **Download agent** window will open — click the appropriate worker version to download it.
{% endhint %}

```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%2FkuHFlY9qrNeYSlrB1bGt%2FGranting%20permission%20for%20installer.png?alt=media&#x26;token=c52cb260-fe93-44fd-bec3-06bd7d9b31e6" alt="Granting permission for installer"><figcaption></figcaption></figure>

2. Next, run the script using the following command:

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

<figure><img src="https://696332517-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FtsE6XtJyUIEKVdSxPlS3%2Fuploads%2FiOexaWkqRPegatxpopR5%2FRunning%20the%20installer.png?alt=media&#x26;token=b9afd345-2a7f-4629-bbc7-561191ad05e7" alt="Running the installer"><figcaption><p><em>Running the script along with <strong><code>sudo</code></strong> command</em></p></figcaption></figure>

{% hint style="warning" %}
The above script should be initiated using an account with administrative privileges— because of that it might be required to use the **`sudo`** command simultaneously (as in the above example).
{% endhint %}

3. Accept the **END-USER LICENSE AGREEMENT** to proceed.

<figure><img src="https://696332517-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FtsE6XtJyUIEKVdSxPlS3%2Fuploads%2FaG2C1LvlxUymuihpvQYr%2FEnd-user%20agreement.png?alt=media&#x26;token=cc527af1-537e-4109-8c5a-7e186e5e53b1" alt="End-user agreement"><figcaption></figcaption></figure>

4. Next, enter the IP address in the **Address** field (including the protocol and port) and click **OK** to finish the installation. Your address can be found in **GitProtect Management Service** — the system will display it once you start downloading the **worker** installer.

<figure><img src="https://696332517-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FtsE6XtJyUIEKVdSxPlS3%2Fuploads%2FfBBPugCNFhvrP20AsL34%2Fimage.png?alt=media&#x26;token=18c6f39e-635a-4295-9f29-e9dcdb76dfd0" alt=""><figcaption></figcaption></figure>

5. Now that **GitProtect** **worker** is installed, you can activate it in the **GitProtect Management Service** web panel and start protecting your data.
   {% endtab %}

{% tab title="MacOS" %}

#### Installation <a href="#installation-mac" id="installation-mac"></a>

1. Download **GitProtect** **worker** installation wizard and run it.

{% hint style="info" %}
To download the worker installer, login to **GitProtect Management Service** using a web browser, then go to **Settings** > **Advanced** > **Workers** and click **Download agent** button. The **Download agent** window will open — click the appropriate worker version to download it.
{% endhint %}

2. Click **Continue** to proceed.

<figure><img src="https://696332517-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FtsE6XtJyUIEKVdSxPlS3%2Fuploads%2FrRh8LrIpMVsLRtqzyiJj%2Fimage.png?alt=media&#x26;token=651f5796-5407-4a66-905c-5f5173f797a3" alt=""><figcaption></figcaption></figure>

3. Select **Continue** 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%2FBTkV0ZM9Ai1TxWpjX225%2Fimage.png?alt=media&#x26;token=41cc3059-b5e1-47ea-8dbf-260551e97502" alt=""><figcaption></figcaption></figure>

4. Read the **END-USER LICENSE AGREEMENT** and hit **Continue** to accept it.

<figure><img src="https://696332517-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FtsE6XtJyUIEKVdSxPlS3%2Fuploads%2F7ZPSewAMXHOIpQFgqrye%2Fimage.png?alt=media&#x26;token=b9707999-2f76-468f-ac98-dff733277b5b" alt=""><figcaption></figcaption></figure>

5. Hit **Agree** to accept the terms of the software license agreement.

<figure><img src="https://696332517-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FtsE6XtJyUIEKVdSxPlS3%2Fuploads%2FjivxBhsmeBtumyUnE27T%2Fimage.png?alt=media&#x26;token=1ef22e84-6283-4532-b1a6-4ebe983c0443" alt=""><figcaption></figcaption></figure>

6. Change the installation directory if needed and click **Install** to begin the installation.

<figure><img src="https://696332517-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FtsE6XtJyUIEKVdSxPlS3%2Fuploads%2FeMMlJgIfiVjEUpqXbCO4%2Fimage.png?alt=media&#x26;token=2a2dd8c6-c445-4a52-bde0-3d6a1daefe1e" alt=""><figcaption></figcaption></figure>

7. During the installation process, the creator will ask you for the address of your **Management Service** — define it in this step. Your address can be found in **GitProtect Management Service**; the system will display it once you start downloading the **worker** installer.

<figure><img src="https://696332517-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FtsE6XtJyUIEKVdSxPlS3%2Fuploads%2FytaGQPkQJiVcGT6UPsbL%2Fimage.png?alt=media&#x26;token=996c16f1-14c1-41cd-9bc3-5a3640e218d3" alt=""><figcaption></figcaption></figure>

8. Click **OK** to confirm your configuration.
9. The **GitProtect** worker has been successfully installed — you can close the installation wizard.

<figure><img src="https://696332517-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FtsE6XtJyUIEKVdSxPlS3%2Fuploads%2FhC3oVuouDiWZzTeImi1J%2Fimage.png?alt=media&#x26;token=5be2145e-72e4-46cc-8939-1bf60a869839" alt=""><figcaption></figcaption></figure>
{% endtab %}
{% endtabs %}
