# 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="../../oprogramowanie-xopero-one/informacje-o-oprogramowaniu/wymagania-systemowe" %}
[wymagania-systemowe](https://helpcenter.xopero.com/xopero-one-en/pl/oprogramowanie-xopero-one/informacje-o-oprogramowaniu/wymagania-systemowe)
{% endcontent-ref %}

{% content-ref url="../../oprogramowanie-xopero-one/informacje-o-oprogramowaniu/obslugiwane-platformy" %}
[obslugiwane-platformy](https://helpcenter.xopero.com/xopero-one-en/pl/oprogramowanie-xopero-one/informacje-o-oprogramowaniu/obslugiwane-platformy)
{% 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="https://content.gitbook.com/content/wg6DDqlTFok8F9zv6rqa/blobs/RFQfPQ9ZsGUuAkqM7gQ0/Granting%20permission%20for%20installer.png" 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="https://content.gitbook.com/content/wg6DDqlTFok8F9zv6rqa/blobs/ZrmDDUGJUVMT7qli9QxI/Running%20the%20installer.png" 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="https://content.gitbook.com/content/wg6DDqlTFok8F9zv6rqa/blobs/v4zkoQ08AyeZ1qOlSolJ/End-user%20agreement.png" 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="https://content.gitbook.com/content/wg6DDqlTFok8F9zv6rqa/blobs/EBKZ7wA4AXWJczVEDXbB/Xopero%20ONE%20service%20URL%20example.png" 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="https://content.gitbook.com/content/wg6DDqlTFok8F9zv6rqa/blobs/6ZeIheZCVkFAx5R0m0Yc/agentmac1.png" alt=""><figcaption></figcaption></figure>

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

<figure><img src="https://content.gitbook.com/content/wg6DDqlTFok8F9zv6rqa/blobs/Sr7zMCOSESE0LssfRugo/agentmac2.png" alt=""><figcaption></figcaption></figure>

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

<figure><img src="https://content.gitbook.com/content/wg6DDqlTFok8F9zv6rqa/blobs/F9K4GGq5HpvaBcJUhaay/agentmac3.png" alt=""><figcaption></figcaption></figure>

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

<figure><img src="https://content.gitbook.com/content/wg6DDqlTFok8F9zv6rqa/blobs/FkbQpZPyEzkwV2WVmd57/agentmac4.png" alt=""><figcaption></figcaption></figure>

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

<figure><img src="https://content.gitbook.com/content/wg6DDqlTFok8F9zv6rqa/blobs/5T3qqsAcXPbbiunSjK85/agentmac5.png" alt=""><figcaption></figcaption></figure>

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

<figure><img src="https://content.gitbook.com/content/wg6DDqlTFok8F9zv6rqa/blobs/0CzOAzDvH1VXfrcKMtJU/agentmac6.png" 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="https://content.gitbook.com/content/wg6DDqlTFok8F9zv6rqa/blobs/dZ1TXd0sRMsdEfCzziae/agentmac7.png" 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="https://content.gitbook.com/content/wg6DDqlTFok8F9zv6rqa/blobs/hqrInokOpsO2kloJA6Lj/image.png" alt=""><figcaption></figcaption></figure>

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

<figure><img src="https://content.gitbook.com/content/wg6DDqlTFok8F9zv6rqa/blobs/DaRIxwucJbqmtUmtmW8U/image.png" 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="https://content.gitbook.com/content/wg6DDqlTFok8F9zv6rqa/blobs/bEAADv4SeTrFwzvJ54tv/image.png" alt="" width="515"><figcaption></figcaption></figure>

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

<figure><img src="https://content.gitbook.com/content/wg6DDqlTFok8F9zv6rqa/blobs/u47scOIXW57IMZybCcPh/image.png" alt=""><figcaption></figcaption></figure>

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

<figure><img src="https://content.gitbook.com/content/wg6DDqlTFok8F9zv6rqa/blobs/amsFP1mB3Zs1HVnk9VlY/image.png" alt="" width="563"><figcaption></figcaption></figure>
{% endtab %}
{% endtabs %}

[^1]: Xopero ONE Management Service


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://helpcenter.xopero.com/xopero-one-en/pl/wdrozenie-i-konfiguracja/xopero-one-agent/instalacja-w-systemie-linux-i-macos.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.