> For the complete documentation index, see [llms.txt](https://helpcenter.xopero.com/xopero-one-en/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://helpcenter.xopero.com/xopero-one-en/pl/wdrozenie-i-konfiguracja/xopero-one-agent/instalacja-w-systemie-linux-i-macos.md).

# Instalacja w systemie Linux i MacOS

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

<p align="center"><a href="#prerequisites" class="button primary" data-icon="circle-1">Wymagania wstępne</a>    <a href="#agent_setup" class="button primary" data-icon="circle-2">Instalacja</a></p>

## Wymagania wstępne

Przed instalacją agenta sprawdź, czy system spełnia wszystkie wymagania. Informacje na ten temat znajdziesz w poniższych artykułach

{% content-ref url="/pages/sWnNuc32ePz2p4zZ0Rdz" %}
[Wymagania systemowe](/xopero-one-en/pl/oprogramowanie-xopero-one/informacje-o-oprogramowaniu/wymagania-systemowe.md)
{% endcontent-ref %}

{% content-ref url="/pages/ZO1Ci3C1rUavK5WvO4ld" %}
[Obsługiwane platformy](/xopero-one-en/pl/oprogramowanie-xopero-one/informacje-o-oprogramowaniu/obslugiwane-platformy.md)
{% endcontent-ref %}

***

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

1. Pobierz instalator **agenta** (**skrypt bash**) na swój system **Linux** i nadaj uprawnienia do wykonywania właścicielowi pliku (użytkownikowi lub grupie) za pomocą polecenia `chmod`:

{% hint style="info" %}
Aby pobrać instalator, zaloguj się do **Xopero ONE Management Service** przez przeglądarkę, przejdź do **Ustawienia > Zaawansowane >** **Workers** i kliknij przycisk **Pobierz agenta**. Otworzy się okno pobierania — wybierz odpowiednią wersję agenta aby ją pobrać.
{% endhint %}

```bash
chmod +x xoperoclient.sh
```

<figure><img src="/files/S4bWOUDLFrYgU2ucgrlW" alt="Granting permission for installer"><figcaption></figcaption></figure>

2. Następnie uruchom skrypt za pomocą polecenia:

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

<figure><img src="/files/Iulz1nYSMcfoWsemvXcE" alt="Running the installer"><figcaption><p><em>Uruchamianie skryptu wraz z komendą <strong><code>sudo</code></strong></em></p></figcaption></figure>

{% hint style="warning" %}
Powyższy skrypt powinien być uruchomiony z **konta z uprawnieniami administracyjnymi** — z tego powodu może być konieczne użycie polecenia `sudo` (jak w powyższym przykładzie).
{% endhint %}

3. Zaakceptuj **Umowę Licencyjną Użytkownika Końcowego** (EULA), aby kontynuować.

<figure><img src="/files/OeSPrfRBKiauZPSfJR0N" alt="End-user agreement"><figcaption></figcaption></figure>

4. Wprowadź **adres IP** w polu **Address** (wraz z protokołem i portem) i kliknij OK, aby zakończyć instalację. Adres ten znajdziesz w **Xopero ONE Management Service** — system wyświetli go w momencie **rozpoczęcia pobierania** instalatora.

<figure><img src="/files/aSsLnvMXBuuDoCZM8UDG" alt="Xopero ONE service URL example"><figcaption></figcaption></figure>

5. Teraz, gdy **agent Xopero ONE** jest zainstalowany, możesz go aktywować w panelu webowym **XMS** i rozpocząć ochronę danych.
   {% endtab %}

{% tab title="MacOS" %}

<p align="center"><a href="#installation-mac" class="button primary" data-icon="circle-1">Instalacja</a>    <a href="#unattended-installation" class="button primary" data-icon="circle-2">Instalacja nienadzorowana</a>    <a href="#permissions-configuration" class="button primary" data-icon="circle-3">Konfiguracja uprawnień</a></p>

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

1. Pobierz kreator instalacji **agenta Xopero ONE** za pośrednictwem XMS[^1] i uruchom go.

{% hint style="info" %}
Aby pobrać instalator, zaloguj się do **Xopero ONE Management Service** przez przeglądarkę, przejdź do **Ustawienia > Zaawansowane >** **Workers** i kliknij przycisk **Pobierz agenta**. Otworzy się okno pobierania — wybierz odpowiednią wersję agenta aby ją pobrać.
{% endhint %}

2. Kliknij **Continue** aby rozpocząć.

<figure><img src="/files/SnFr4lkOqoVEsuSU1Ibx" alt=""><figcaption></figcaption></figure>

3. Wybierz **Continue** w sekcji **Read Me**.

<figure><img src="/files/jkitdX49xJ10aY8v46UO" alt=""><figcaption></figcaption></figure>

4. Przeczytaj **Umowę Licencyjną** (**EULA**) i kliknij **Continue**, aby ją zaakceptować.

<figure><img src="/files/olfwJtFYFDYvGG19VFCa" alt=""><figcaption></figcaption></figure>

5. Kliknij **Agree** aby zaakceptować warunki licencji oprogramowania.

<figure><img src="/files/GJn9cC8tonjU4DRR7GxF" alt=""><figcaption></figcaption></figure>

6. W razie potrzeby zmień katalog instalacyjny i kliknij **Install** aby rozpocząć instalację.

<figure><img src="/files/TRNgvOhefGxy2leX25Dl" alt=""><figcaption></figcaption></figure>

7. Podczas procesu instalacji kreator poprosi o adres **XMS** — podaj go w tym kroku.

<figure><img src="/files/WQqJqCE5kex7M9qDPr7b" alt=""><figcaption></figcaption></figure>

8. Kliknij **OK**, aby potwierdzić konfigurację.
9. **Agent Xopero ONE** został pomyślnie zainstalowany — możesz zamknąć kreator instalacji.

<figure><img src="/files/BM0Fn1SsBNbUZ59vMpip" alt=""><figcaption></figcaption></figure>

***

## Instalacja nienadzorowana

Jeśli nie chcesz korzystać z kreatora instalacji, możesz wybrać opcję instalacji nienadzorowanej.

1. Pobierz plik `xoperoclient.pkg` na swoje urządzenie.

{% hint style="info" %}
Aby pobrać instalator, zaloguj się do **Xopero ONE Management Service** przez przeglądarkę, przejdź do **Ustawienia > Zaawansowane >** **Workers** i kliknij przycisk **Pobierz agenta**. Otworzy się okno pobierania — wybierz odpowiednią wersję agenta aby ją pobrać.
{% endhint %}

2. Uruchom następujące polecenie w terminalu macOS (**Aplikacje** > **Narzędzia** > **Terminal**):

{% code overflow="wrap" %}

```bash
sudo /bin/launchctl setenv "XOPERO_INSTALLER_SERVER_ADDRESS_CONFIG" "https://XMS_adress::28555>" && sudo installer -pkg <pkg_file_location> -target /; sudo /bin/launchctl unsetenv "XOPERO_INSTALLER_SERVER_ADDRESS_CONFIG"
```

{% endcode %}

> **‼️Przegląd polecenia:**
>
> {% code title="Ustawienie zmiennej środowiskowej z adresem IP oraz domyślnym portem XMS:" overflow="wrap" %}
>
> ```bash
> sudo /bin/launchctl setenv "XOPERO_INSTALLER_SERVER_ADDRESS_CONFIG" "https://<XMS_adress::28555>"
> ```
>
> {% endcode %}
>
> {% code title="Uruchomienie instalatora" overflow="wrap" %}
>
> ```bash
> sudo installer -pkg <pkg_file_location> -target /;
> ```
>
> {% endcode %}
>
> {% code title="Usunięcie zmiennej środowiskowej" overflow="wrap" %}
>
> ```bash
> sudo /bin/launchctl unsetenv "XOPERO_INSTALLER_SERVER_ADDRESS_CONFIG"
> ```
>
> {% endcode %}

***

## Konfiguracja uprawnień

Po instalacji należy w kilku krokach dodać niezbędne uprawnienia dla plików **Xopero**.

1. Kliknij ikonę **Mac** w lewym górnym rogu i wybierz **System preferences** z menu rozwijanego

<figure><img src="/files/0yAHZg21Jt3GYJPfd1Tt" alt=""><figcaption></figcaption></figure>

2. Przejdź do sekcji **Security & Privacy**.

<figure><img src="/files/il6QshJ6YkU5WXMNC1Mx" alt="" width="517"><figcaption></figcaption></figure>

3. Przejdź do karty **Privacy**, następnie wybierz **Full Disk Access** z menu po lewej stronie.

<figure><img src="/files/gA0BTrv0amXFR3UdqpyM" alt="" width="515"><figcaption></figcaption></figure>

4. Dodaj **`Xopero.Device.App.app`** do listy.

<figure><img src="/files/cQhfGFA6OsHhWAQhlxQg" alt=""><figcaption></figcaption></figure>

5. Nadaj uprawnienia aplikacji **`Xopero.Device.App.app`** aby ukończyć konfigurację.

<figure><img src="/files/ySqF5rHAaDfHqE9MywoQ" alt="" width="563"><figcaption></figcaption></figure>
{% endtab %}
{% endtabs %}

[^1]: Xopero ONE Management Service