# Installing Sherpa Coordinator on RedOS

> Sudo privileges are required for installation

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

## Installing .NET Core 8 and PowerShell

General installation instructions are provided on the Microsoft website:

{% embed url="<https://learn.microsoft.com/ru-ru/dotnet/core/install/linux-fedora>" %}

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

**Execute in the terminal:**

* Install the .NET SDK 8.0:

```
sudo dnf install -y dotnet-sdk-8.0
```

* Install PowerShell

```
sudo dnf install https://github.com/PowerShell/PowerShell/releases/download/v7.4.2/powershell-7.4.2-1.rh.x86_64.rpm
```

## Installing the xfreerdp Program

To allow the Coordinator to create remote connections to Unattended robots, the xfreerdp program must be installed. To do this, execute the command:

```
sudo dnf install freerdp2
```

## Downloading and Unpacking the Coordinator

To download and unpack the Coordinator, a series of commands must be executed.

**Execute 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 execution rights 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, a user must be created and automatic login must be enabled for that user.

To enable automatic startup of the Coordinator, a User must be created and automatic login must be enabled for that user.

* Create a new User named sherpacoordinator;
* Go to "Control Center" → "User Management".
* "Start" → "System" → "Security Policy".
* **Execute in the terminal:**

  * Add the User sherpacoordinator to the wheel group:

  `sudo usermod -aG wheel sherpacoordinator`
* Enable autostart for the newly created account.

  * Edit the file /etc/gdm/custom.conf:

  `sudo mcedit /etc/gdm/custom.conf`

  * Make the following settings in custom.conf

  `[daemon]`

  `WaylandEnable=false`

  `TimedLoginEnable = true`

  `TimedLogin = sherpacoordinator`

  `TimedLoginDelay = 10`
* Restart the server.

## Configuring the Coordinator

Configuration is performed in the previously created account:

* Create a shortcut for the autostart of the Coordinator,
* Specify the Orchestrator server,
* Specify the Coordinator GUID in the Coordinator server settings.

**Execute 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.

* **Execute in the terminal:**

  * Open the file `setting.ini` in the `mcedit` editor to edit the settings:

  `mcedit /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.
* **Execute 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-redos.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.
