---
title: "IGEL Installation Guide"
slug: "igel-installation-guide"
updated: 2026-07-15T17:23:12Z
published: 2026-07-15T17:23:12Z
canonical: "support.nectarcorp.com/igel-installation-guide"
---

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

# IGEL Installation Guide

## Installing and Configuring the Agent

This chapter provides instructions for installing and performing initial configuration of the **Nectar Endpoint Client** (henceforth EPC) on an IGEL OS 12 device.

### Prerequisites

Before starting, confirm that:

- The target device is running IGEL OS 12 and is registered with your UMS instance.
- Your UMS has a valid Workspace Edition or IGEL Subscription License.
- Your UMS is registered with the IGEL Customer Portal at [https://support.igel.com/csm](https://support.igel.com/csm) with **Enable App Portal** turned on. Without this, devices cannot download apps from the App Portal and deployments will fail with an HTTP error.
- The user performing the deployment has the **UMS Admin** or **Super Admin** role.
- You have your Domain Name, Domain Access Code, Organization ID, and Organization Group ID. If you do not, contact [support@nectarcorp.com](mailto:support@nectarcorp.com).

### Download from IGEL App Portal

Sign in to the [IGEL App Portal](https://app.igel.com) and download the app named **Nectar Endpoint Client**. The downloaded file is `nectarepc.ipkg`.![](https://cdn.document360.io/f8330b7a-360f-4ca0-b0ac-2664b7c04c49/Images/Documentation/image-M2KAKY5V.png?sv=2026-02-06&spr=https&st=2026-11-11T05%3A08%3A40Z&se=2026-11-11T06%3A08%3A40Z&sr=c&sp=r&sig=hFoUowIJenRZl%2Bvp%2BkKGvvOiitEEraDXURcslJzViHc%3D)

### Upload to UMS

Log in to your UMS Web App.

1. From the sidebar, select **Apps**.
2. Click **Import App**.
3. Choose the `nectarepc.ipkg` file you just downloaded.

![](https://cdn.document360.io/f8330b7a-360f-4ca0-b0ac-2664b7c04c49/Images/Documentation/image-RVUKYLGZ.png?sv=2026-02-06&spr=https&st=2026-11-11T05%3A08%3A40Z&se=2026-11-11T06%3A08%3A40Z&sr=c&sp=r&sig=hFoUowIJenRZl%2Bvp%2BkKGvvOiitEEraDXURcslJzViHc%3D)

### Configure EPC App

Once the EPC app appears in the Apps list, open it.

![](https://cdn.document360.io/f8330b7a-360f-4ca0-b0ac-2664b7c04c49/Images/Documentation/image-MBDP9779.png?sv=2026-02-06&spr=https&st=2026-11-11T05%3A08%3A40Z&se=2026-11-11T06%3A08%3A40Z&sr=c&sp=r&sig=hFoUowIJenRZl%2Bvp%2BkKGvvOiitEEraDXURcslJzViHc%3D)

First, click **Edit Update Settings** and set the following:

- **Automatic Check for Updates in UMS** = *Check for updates and auto-import into UMS*
- **Default Version for Assigned Devices** = *Auto-update Default Version to newest version*

Next, click **Create New Profile**

1. Name the Profile and set the profile location as desired.
2. Under **Endpoint Client Configuration**, open **Endpoint Client Settings**.
3. Enable and enter provided values for *Domain Name* and *Domain* *Access Code.*
  1. If you never received a Domain Name/Access Code, please contact support@nectarcorp.com
4. Enable *Controller Port Fixed* and leave the default value `false`.
5. Enable *Controller Address* and enter `neccontroller.us.nectar.services` .
6. Enable and enter provided values for *Organization ID* and *Organization Group ID.*
  1. If you never received an Organization/Group ID, please contact support@nectarcorp.com
7. Enable *Agent Log Level* and enter `6`.

### Distribute EPC App

From **Devices** in the UMS Web App, assign the profile (and the EPC app, if it is not already attached) to the target devices, directories, or device groups.

To verify the deployment:

- Check the Nectar EPC Reporter console for the new device (contact your Nectar PS Representative for assistance)
- Open a root terminal on the device and run

```bash
systemctl status nectarepc.service
```

Confirm that the service is **enabled** and **active (running)**.

## Uninstalling the Agent

To remove EPC from IGEL devices, open the UMS Web App. From the assigned objects list on the device or directory, locate the Nectar Endpoint Client app or profile, then click **Detach Object**.

## Troubleshooting

### App Fails to Download with "HTTP error during download"

The UMS is not registered with the IGEL Customer Portal with App Portal access enabled. See [Prerequisites](/v1/docs/igel-installation-guide#download). Registration is performed at [https://cosmos.igel.com/csm](https://cosmos.igel.com/csm) under **Configure Services → UMS Registration**, where the **Enable App Portal** toggle must be turned on.

### Agent Will Not Connect to the Controller

If the agent is configured with the Controller address and port but cannot connect, a firewall on the Controller host may be blocking incoming agent connections (default TCP 443). Confirm that the Controller's firewall allows traffic on this port. As a workaround, you can manually register the agent in the Nectar EPC-Controller Reporter UI.

### Service Is Not Running

If `systemctl status nectarepc.service` shows the service as failed or inactive, restart it and inspect the journal:

```bash
systemctl restart nectarepc.service
journalctl -u nectarepc.service -n 100 --no-pager
```

Please sent this journal to your Nectar PS Representative.

### Problems Running Tests

If the agent installs and configures successfully but cannot execute tests, the issue is most often a firewall blocking required ports. See [Ports and Protocols](/v1/docs/clone-ports-and-protocols-guide) for the full list.

For additional support, contact [support@nectarcorp.com](mailto:support@nectarcorp.com).