# Installing Sherpa RPA on OSnova

> Sudo privileges are required for installation.

**Disable memory protection:**

* To permanently disable it, add the following to the configuration file /etc/default/grub:

`GRUB_CMDLINE_LINUX_DEFAULT="quiet mprotect=off"`

* Update GRUB:

`sudo update-grub`

* Restart the computer.

**Add the Debian repository to install the libgdiplus library:**

* **For OSnova 2:**

  * Download the file:

  `sudo wget https://dl.nppct.ru/onyx/stable/misc/apt/sources.list.d/zz-debian-10-buster.list`

  * Save the downloaded file to the directory /etc/apt/sources.list.d/:

  `-P /etc/apt/sources.list.d/`
* **For OSnova 3:**

  * Download the file:

  `sudo wget https://dl.nppct.ru/onyx3/stable/misc/apt/sources.list.d/zz-debian-12-bookworm.list`

  * Save the downloaded file to the directory /etc/apt/sources.list.d/:

  `-P /etc/apt/sources.list.d/`

**Download the package lists from the configured repositories:**

`sudo apt update`

## 1. Installing .NET **Core 8**

General installation instructions are available 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>" %}

**Execute in the terminal:**

* Download the installer file:

  * **For OSnova 2:**

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

  * **For OSnova 3:**

  `wget https://packages.microsoft.com/config/debian/12/packages-microsoft-prod.deb -O packages-microsoft-prod.deb`
* Install the downloaded file:

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

* Remove the temporary installer file:

`rm packages-microsoft-prod.deb`

* Update the package list:

`sudo apt update`

* Install .NET SDK version 8.0:

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

* Install PowerShell:

`sudo apt install -y powershell`

## 2. Installing the libgdiplus library

To enable keyboard and mouse emulation, install the libgdiplus library.

**Execute in the terminal:**

`sudo apt install libgdiplus`

## 3. Installing Tesseract

To work with Tesseract, execute the following command in the terminal:\
\
`sudo apt install tesseract-ocr-rus`

If you plan to use Tesseract OCR or the automatic page rotation recognition feature in the Template Designer, to improve the quality of the results, follow these steps:

* Download the archive

`wget` [`https://sherparpa.ru/downloads/traineddata.zip`](https://sherparpa.ru/downloads/traineddata.zip) `-O traineddata.zip`

* Unzip it to the folder

`sudo unzip -o traineddata.zip -d /usr/share/tesseract-ocr/4.00/tessdata`

## 4. Downloading and running the installer

Remove the old version of the installer and download the new one.

**Execute in the terminal:**

* Remove the old version of the installer:

`rm -f SherpaRPA` ;

* Download the latest version of the installer:

`wget https://sherparpa.ru/downloads/linux/SherpaRPA.php -O SherpaRPA` ;

* Set the file execution flag:

`chmod +x SherpaRPA` ;

* Run the installer:

`./SherpaRPA` .

> To download and run the installer, you can enter this line in the terminal. It contains all the commands described above: rm -f SherpaRPA && wget <https://sherparpa.ru/downloads/linux/SherpaRPA.php> -O SherpaRPA && chmod +x SherpaRPA && ./SherpaRPA

To install Sherpa RPA, follow the instructions below:

* If the Robot was installed previously, you will see a window notifying you of this. In it, you can choose "Install" (to update the Robot) or "Remove" (to uninstall the Robot);

<figure><img src="https://3212714295-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FI0zUnKkOuy6lWt7DZ46u%2Fuploads%2Fgit-blob-5b272403946181566ed27bf6508d8efa7df4fd01%2Fimage%20(77).png?alt=media" alt=""><figcaption></figcaption></figure>

* If this is the first installation, or if you selected "Install" in the previous window, the installer window will appear. You will be able to choose:

  * creating a shortcut on the desktop,
  * creating a folder in the "Start" menu,
  * installing the Robot for the current User / for all Users;

  <figure><img src="https://3212714295-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FI0zUnKkOuy6lWt7DZ46u%2Fuploads%2Fgit-blob-7a5ed74d80923b1617900cf8239e31576cb97452%2Fimage%20(79).png?alt=media" alt=""><figcaption></figcaption></figure>
* Then click the "Next" button;
* Choose a folder for installing the Robot and click the "Next" button;

<figure><img src="https://3212714295-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FI0zUnKkOuy6lWt7DZ46u%2Fuploads%2Fgit-blob-31ff4fcdb8193c3962fe9b1d5ae0c4597dd14ffd%2Fimage%20(81).png?alt=media" alt=""><figcaption></figcaption></figure>

* Next, a window will appear showing the installation process of the Robot;

<figure><img src="https://3212714295-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FI0zUnKkOuy6lWt7DZ46u%2Fuploads%2Fgit-blob-73b83edeee5315373cf54cfb1b7828b51ecf6652%2Fimage%20(87).png?alt=media" alt=""><figcaption></figcaption></figure>

* When the installation is complete, you will see a window where you can immediately launch Sherpa Designer by clicking the "Launch" button.

<figure><img src="https://3212714295-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FI0zUnKkOuy6lWt7DZ46u%2Fuploads%2Fgit-blob-1d1c312d5fec497c9db8d16ccdc73deb561f12a9%2Fimage%20(86).png?alt=media" alt=""><figcaption></figcaption></figure>

## 5. Installing the plugin in Yandex Browser

To enable the Robot to work with Yandex Browser, you need to install a plugin:

* Open the browser and go to the "Extensions" section;
* Navigate to the folder with the installed Robot:

`/home/user/.config/sherpa-rpa/sherpa-robot` ;

* Go to the Chrome folder:

`/home/user/.config/sherpa-rpa/sherpa-robot/Chrome` ;

* Drag the `plugin.crx` file into the browser window;
* Add the extension;
* Close the browser;
* Open a terminal window in the current folder and execute the following commands:

`chmod +x install_host.sh` ;

`./install_host.sh` ;

* Launch the browser.

If the Sherpa RPA plugin icon has turned blue, it means the plugin has been successfully installed.

The plugin can also be installed from the website:

{% embed url="<https://chrome.google.com/webstore/detail/sherpa-rpa/bdnlfnchnkjeempadnmcgbbkbacffobl>" %}

And then perform steps 3, 4, and 5.