# Installing Sherpa Coordinator on Astra Linux

> Sudo rights are required for installation

If the program is already installed, go to the [Downloading and Unpacking](#skachivanie-i-raspakovka-koordinatora) section to update it.

## Installing .NET Core 8 and PowerShell

General installation instructions are provided on the Microsoft website:

{% embed url="<https://docs.microsoft.com/en-us/dotnet/core/install/linux-debian>" %}

{% embed url="<https://docs.microsoft.com/en-us/powershell/scripting/install/install-debian?view=powershell-7.2>" %}

**Run in the terminal:**

* Download the configuration file:

```
wget https://packages.microsoft.com/config/debian/10/packages-microsoft-prod.deb -O packages-microsoft-prod.deb
```

* Install the downloaded package:

```
sudo dpkg -i packages-microsoft-prod.deb
```

* Remove the temporary file:

```
rm packages-microsoft-prod.deb
```

* Update the package list:

```
sudo apt-get update
```

* Install .NET SDK 8.0:

```
sudo apt-get install -y dotnet-sdk-8.0
```

* Install PowerShell:

```
sudo apt-get install -y powershell
```

## Installing the xfreerdp Program

To allow the Coordinator to create remote connections to Unattended robots, you need to install the xfreerdp program. To do this, execute the command:

```
sudo apt-get install freerdp2-x11
```

## Downloading and Unpacking the Coordinator

To download and unpack the Coordinator, you need to execute a series of commands.

**Run in the terminal:**

* Remove the file sherpa-coordinator.zip:

```
rm -f sherpa-coordinator.zip
```

* Download the file sherpa-coordinator.zip:

```
wget https://sherparpa.ru/downloads/linux/get-coordinator.php -O sherpa-coordinator.zip
```

* Unzip the ZIP archive:

```
sudo unzip -o sherpa-coordinator.zip -d /usr/lib
```

* Grant execute permissions for the sherpa-coordinator file:

```
sudo chmod a+x /usr/lib/sherpa-coordinator/sherpa-coordinator
```

> To install or update the Coordinator to the latest version, you can enter this command in the terminal. It combines all the commands described above: `rm -f sherpa-coordinator.zip && wget https://sherparpa.ru/downloads/linux/get-coordinator.php -O sherpa-coordinator.zip && sudo unzip -o sherpa-coordinator.zip -d /usr/lib && sudo chmod a+x /usr/lib/sherpa-coordinator/sherpa-coordinator`

## Initial Setup

To enable automatic startup of the Coordinator, you need to create a User and enable automatic login for it.

* Create a new User named sherpacoordinator;
* Launch the management center. To do this, enter the command:

```
sudo fly-admin-center
```

* Go to "Security" → "Security Policy" or select in the Start menu "System" → "Security Policy".
* **Run in the terminal:**

  * Add the User sherpacoordinator to the sudo group:

  `sudo usermod -aG sudo sherpacoordinator`

  * Add the User sherpacoordinator to the astra-admin group:

  `sudo usermod -aG astra-admin sherpacoordinator`
* Enable auto-login for the newly created account. Launch the management center with the command:

  `sudo fly-admin-center`

  Or select the menu item "Start" → "Control Panel" → section "System" → "Login".
* In the "Advanced" tab, enable the "Allow automatic login" option and select the previously created User.
* Restart the server.

## Configuring the Coordinator

Configuration is performed in the previously created account:

* Create a shortcut for the Coordinator to autostart,
* Specify the Orchestrator server,
* Specify the Coordinator GUID in the Orchestrator server settings.
* **Run in the terminal:**

  * Change the permissions of the sherpa-coordinator file:

  `sudo chmod a+x /usr/lib/sherpa-coordinator/sherpa-coordinator`

  * Run the sherpa-coordinator file:

  `/usr/lib/sherpa-coordinator/sherpa-coordinator`

After the first launch, an error message will appear. You need to specify the settings.

* **Run in the terminal:**

  * Open the setting.ini file in the kate editor to edit the settings related to the Coordinator configuration:

  `kate /home/sherpacoordinator/.config/sherpa-rpa-data/coordinator/setting.ini`
* Specify the Orchestrator server:
  * `OrchestratorServer` — Orchestrator server;
  * `OrchestratorRobotGuid` — Coordinator GUID from the Orchestrator.
* If necessary, you can change other settings:
  * `OrchestratorTimeout` – connection time to the Orchestrator;
  * `TimeResetHungSessions` – time in minutes after which the Coordinator will terminate hung sessions;
  * `DesktopWidth` – width of the created RDP window;
  * `DesktopHeight` – height of the created RDP window.
* Save the settings.
* **Run in the terminal:**

  * Create the autostart directory in the User's configuration folder:

  `mkdir $HOME/.config/autostart`

  * Copy the file to the current User's autostart folder:

  `cp -f /usr/lib/sherpa-coordinator/sherpa-coordinator.desktop $HOME/.config/autostart`
* Restart the server, and after that, the status of the Coordinator in the Orchestrator should become "Ready".


---

# 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://docs.sherparpa.ru/en/sherpa-rpa/sherpa-orchestrator/razvertyvanie-platformy-pod-upravleniem-orkestratora/ustanovka-sherpa-rpa-coordinator/ustanovka-sherpa-coordinator-na-os-astra-linux.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.
