---
title: "IGEL: Install Sanas app"
slug: "igel-install-sanas-app-1"
updated: 2025-11-14T13:58:03Z
published: 2025-11-14T13:58:03Z
canonical: "help.sanas.ai/igel-install-sanas-app-1"
---

> ## Documentation Index
> Fetch the complete documentation index at: https://help.sanas.ai/llms.txt
> Use this file to discover all available pages before exploring further.

# IGEL: Install Sanas app

This guide provides comprehensive instructions to install the Sanas app on an IGEL environment. The installation method covered in this guide is for custom app deployment on older IGEL OS, and IGEL OS 12.

### Before you begin:

- For IGEL older IGEL OS (below version 12), you must have received the Sanas app package `.tar.bz2` from Sanas. If not, contact [Sanas Support](mailto:support@sanas.ai) for assistance.
- Ensure you have the required administrative privileges to deploy the custom app on the IGEL environment.

---

### Installation procedure

IGEL OS 12IGEL OS older versions

> [!NOTE]
> Sanas is available on the IGEL App Portal.
> 
> Sanas is now IGEL-verified and available on the IGEL App Portal for IGEL OS version 12. The Sanas app can be downloaded directly from the App Portal on endpoint machines or deployed by admins through IGEL UMS.

The guide below explains how to install the Sanas application on an IGEL machine running OS version 12 or later. If you are running an older IGEL OS version, please refer to the applicable procedure available in this guide.

#### Installing Sanas directly on the endpoint machine

1. Log in to your IGEL machine using your credentials.
2. Launch the IGEL App Portal.
3. Search **Sanas** through the search field, or look for Sanas under the *Unified Communication* app category.
4. Select Sanas from the search result, then click **Install**.

![IGEL App Portal displaying various applications with an install option highlighted.](https://cdn.document360.io/9bc36e9c-f402-4213-b56f-4ecdf805bb1a/Images/Documentation/Untitled(6).png)

Sanas on IGEL App Portal
5. Click **Continue** to proceed with the installation. Downloading starts automatically.

![Installation prompt for Sanas Real Time Speech Application with options to continue or cancel.](https://cdn.document360.io/9bc36e9c-f402-4213-b56f-4ecdf805bb1a/Images/Documentation/Untitled(7).png)

Confirm installation
6. You’ll need to restart your machine to start using Sanas. Click **Restart now** to proceed.
7. Once back, launch the Sanas app and enter your credentials (*Workspace ID* + *User ID*) and click **Activate**.
8. Refer to the [Sanas User Guide](/v1/docs/using-sanas-app) for detailed instructions on using the Sanas app.

#### Installing Sanas through IGEL UMS

This guide helps you to deploy the Sanas app through IGEL UMS on the connected endpoint IGEL machines.

1. Log in to IGEL UMS as admin using your credentials.
2. Navigate to the App Portal.
3. Search **Sanas** through the search field, or look for Sanas under the *Unified Communication* app category.
4. From the search results, click **Import** to proceed with installation.

![IGEL App Portal displaying Sanas Real Time Speech Application with download details highlighted.](https://cdn.document360.io/9bc36e9c-f402-4213-b56f-4ecdf805bb1a/Images/Documentation/Untitled(8).png)

Import Sanas to IGEL UMS
5. Click **Continue** to confirm your action.

![Instructions to import the Sanas Real Time Speech application with options to continue or cancel.](https://cdn.document360.io/9bc36e9c-f402-4213-b56f-4ecdf805bb1a/Images/Documentation/Untitled(9).png)

Confirmation
6. Once imported, set the app download method on the endpoint devices.
  1. From the App Portal page, navigate to **Settings**.

![Settings menu for Unified Communication applications, highlighting Sanas Real Time Speech Application.](https://cdn.document360.io/9bc36e9c-f402-4213-b56f-4ecdf805bb1a/Images/Documentation/Untitled(10).png)

App Portal Settings
  2. Under **Device should download the Apps from** drop down menu, select **Download directly from App Portal** then click **Save**.

![Settings menu for UMS as an Update Proxy with download options highlighted.](https://cdn.document360.io/9bc36e9c-f402-4213-b56f-4ecdf805bb1a/Images/Documentation/Untitled(11).png)
7. Now, from the UMS portal, select **Devices** from the left-side navigation bar and select the endpoint device where you wish to deploy Sanas.

![Device list showing details for various IT laptops and desktops in a directory.](https://cdn.document360.io/9bc36e9c-f402-4213-b56f-4ecdf805bb1a/Images/Documentation/Untitled(12).png)

Select an endpoint device for deployment.
8. Click **Assign Object**, then select and drag Sanas from the **Available Objects** to the **Assignments** section. Select your desired Sanas app version to deploy from the drop-down menu, if required.

![Assigning the Sanas Real Time Speech Application to a device in the management interface.](https://cdn.document360.io/9bc36e9c-f402-4213-b56f-4ecdf805bb1a/Images/Documentation/Untitled 2(3).png)

Assign object
9. Click **Save and apply on reboot** to apply the changes. Sanas gets installed after rebooting the endpoint machines.
10. Test the Sanas app by launching and activating the app. You'll need the *Workspace* and *User* *ID* for activation. Refer to the [Sanas User Guide](/v1/docs/using-sanas-app) for detailed instructions on using the Sanas app.

IGEL installation is divided into 5 key steps, covering the app preparation in steps 1 to 3, and deployment in steps 4 and 5.

1. #### **Keep the Sanas app package ready**

Ensure you have received the Sanas app package file (`.tar.bz2`) and have kept it ready to upload in the upcoming steps. If you haven’t received the file from us, contact Sanas Support for assistance.
2. #### **Create the** `inf` **configuration file**

The `.inf` file communicates with IGEL OS about application archive handling.
  1. Open a text editor of your choice on your Linux or Windows machine.
  2. Create a new file named:

```bash
Sanas-4.1.12.inf
```
  3. Add the following configuration details (example structure shown below — adapt as needed for your environment):

> [!NOTE]
> 📔**Notes**:
> 
> **1.** The configuration below uses the package name based on the file provided by Sanas, and may change in the future based on the app package version.
> 
> **2.** The value for mount “***/sanas***" must be replaced with the currently used mount you’ve used to deploy other apps.

```bash
[PARTITION]
name=Sanas
version=4.1.12
archive="Sanas-4.1.12-prod.tar.bz2"
size=400M
mount=/sanas
```
  4. Save the file.
3. #### **Upload files to IGEL Universal Management Suite (UMS)**
  1. Navigate to the **UMS Console**.
  2. Go to **Files → New File**.

![Create new file](https://cdn.document360.io/9bc36e9c-f402-4213-b56f-4ecdf805bb1a/Images/Documentation/image(636).png)

Create a new file
  3. Upload both prepared files from the previous steps:
    - `Sanas-4.1.12-prod.tar.bz2`
    - `Sanas-4.1.12.inf`

![Upload files](https://cdn.document360.io/9bc36e9c-f402-4213-b56f-4ecdf805bb1a/Images/Documentation/image(635).png)

Upload prepared files
  4. Set the **Device File Location** to:

```bash
/wfs/<filename>
```
  - Confirm that the files are available by opening them in a browser:

```bash
https://<server:port>/ums_filetransfer
```
4. #### **Create and configure a new profile**
  1. **Profile creation**
    1. In UMS, go to **Profiles → New Profile**

![Create a new profile.](https://cdn.document360.io/9bc36e9c-f402-4213-b56f-4ecdf805bb1a/Images/Documentation/image(634).png)

Create a new profile
    2. Enter a **Profile Name** and **Description**.
    3. Select the correct **IGEL OS version**.

> [!WARNING]
> 📔**Important**: The Sanas app supports installation on **IGEL OS versions 11 and earlier**, with custom app deployment.

![Select IGEL OS version.](https://cdn.document360.io/9bc36e9c-f402-4213-b56f-4ecdf805bb1a/Images/Documentation/image(633).png)

Enter description and select OS version
    4. Open the created profile.
  2. **Profile configuration**
    1. Go to,

**System → Firmware Customization → Custom Partition → Partition**
    2. Enable **Partition, Size & Mount Point**.
    3. Set:
      - **Mount Size**: 400 MB (recommended)
      - **Mount Point**: <enter_name> ; For example, the below image shows `/sanas` as the mount name.

> [!NOTE]
> 📔**Note**: **/sanas** is an example mount. Please use your existing mount that is used to deploy other apps.

![Define partition size and mount.](https://cdn.document360.io/9bc36e9c-f402-4213-b56f-4ecdf805bb1a/Images/Documentation/image(632).png)

Select partition size and mount
    4. Save the settings.
  3. **Link the** `inf` **configuration file**
    1. Navigate to the URL below and copy the `.inf` file URL:

```bash
https://<server:port>/ums_filetransfer
```

![Copy the link address for the uploaded .inf file.](https://cdn.document360.io/9bc36e9c-f402-4213-b56f-4ecdf805bb1a/Images/Documentation/image(631).png)

Copy link of uploaded .inf file
    2. In the profile, go to:

**System → Firmware Customization → Custom Partition → Download**
    3. Click **Add** and paste the URL.
    4. Enter the **Username** and **Password**, then **Save**.

![Enter values for URL, User name, and Password fields.](https://cdn.document360.io/9bc36e9c-f402-4213-b56f-4ecdf805bb1a/Images/Documentation/image(630).png)

Enter values for URL, User name, and Password
  4. Configure the application

iv. Save the profile.
    1. In the profile, go to:

**System → Firmware Customization → Custom Application**
    2. Create a new session named **Sanas**.

![Enter session name as Sanas](https://cdn.document360.io/9bc36e9c-f402-4213-b56f-4ecdf805bb1a/Images/Documentation/image (1).png)

Enter session name
    3. Configure icon name and command:

> [!WARNING]
> ℹ️**Important**: The paths shown below are examples. Your path directory will differ based on the mount selected in the previous steps.
      - **Icon Path**:

```plaintext
/<mountname>/Sanas-4.1.12-prod/data/flutter_assets/assets/icons/icon.png
```

***Example***: Below is a sample command with the mount name ‘custom’ `/custom/Sanas-4.1.12-prod/data/flutter_assets/assets/icons/icon.png`
      - **Command to Launch**:

```bash
/<mountname>/Sanas-4.1.12-prod/sanas_app
```

**Example**: Below is a sample command with the mount name ‘custom’ `/custom/Sanas-4.1.12-prod/sanas_app`

![Enter vales for Icon name and Command fields](https://cdn.document360.io/9bc36e9c-f402-4213-b56f-4ecdf805bb1a/Images/Documentation/image(629).png)

Enter icon name and command values
      - Customize desktop integration settings as required.

![Custom desktop integration settings](https://cdn.document360.io/9bc36e9c-f402-4213-b56f-4ecdf805bb1a/Images/Documentation/image(628).png)

(Optional) Customize deskotp integration
5. #### **Deploy the profile to devices**
  1. Assign the new profile to the desired IGEL devices or directories.
  2. Restart the devices.
  3. On reboot, IGEL will:
    - Mount the custom partition.
    - Install the Sanas application.
    - Display the **Sanas app icon** on the desktop.
6. #### **Launch and activate**
  1. Double-click the **Sanas app icon** on the IGEL desktop.
  2. Enter your **Workspace ID** and **User ID**.

![User interface for activating the Sanas app.](https://cdn.document360.io/9bc36e9c-f402-4213-b56f-4ecdf805bb1a/Images/Documentation/image .png)

Launch the Sanas app
  3. Click **Activate Key** to activate the app.

![IGEL VNC Viewer interface displaying accent translation options and audio input settings.](https://cdn.document360.io/9bc36e9c-f402-4213-b56f-4ecdf805bb1a/Images/Documentation/image(627).png)

Activate the app, and start using it.

---

### Support

**Need help?** Get in touch with our [Support Team](mailto:support@sanas.ai) for assistance.