---
title: On-prem Agent
slug: neurons-ipaas/help/enu/latest/on-prem-agent
createdAt: 2026-05-19T13:16:49.748Z
---

With Neurons for ITSM On-prem Agent, you can securely connect to authorized on-premise applications and databases that are hosted within private IT environment behind firewalls to ITSM cloud without compromising the security of on-premise systems.

:::hint{type="info"}
The On-prem Agent feature is licensed separately, to avail the license and/or know more, reach out to Ivanti Support.
:::

## Setting up On-prem - workflow

Create a group > Add an Agent (Select OS > Download and install agent > Activate the agent > Test the agent) > Add Connections.

## On-prem Groups

With On-prem Groups, you can logically group multiple agents into a common connection pool. For instance, if you have a development environment with multiple applications and databases such as SQL, Jira, and Salesforce, you can pool them in a group to achieve High Availability. For more information on the advantages of On-prem groups and High Availability, see [Workato On-prem Group](https://docs.workato.com/on-prem/groups.html#high-availability).

### Create a Group

1. Log in to Neurons for ITSM as an Administrator.
2. Open the Configuration console, select **Tools** > **On-prem Groups** > **New Group**.
3. Enter a Group Name, select **Set up connections** as **Directly in Workato**.

:::hint{type="info"}
It is recommended to select **Directly in Workato** rather than **Manually in each agent**.
:::

A group is created. The next step is to add an agent to each server. If you have three servers in the group, you must add agents to all three servers.

### Add Agent

1. Click **Add On-prem Agent**.
2. Provide necessary details in the **Choose OS** section.
3. Download the installer.
4. When the download is complete, open the **.exe** file and install the agent.
5. While it is getting installed, click **Next** on the **Add Agent** page and copy the **Activation code**.

::Image[]{src="https://api.archbee.com/api/optimize/parib0MC3hVoUNdfQdnac/4DIIhZ5-DXP0d_C32s7P4_activationcode.png" position="flex-start" size="40" initialPath="images/ActivationCode.png" githubPath="iPaaS/images/ActivationCode.png" width="1297" height="676" darkWidth="1297" darkHeight="676" showCaption="false" indent="1"}

6. Enter the Activation code when prompted after the installation is complete.

::Image[]{src="https://api.archbee.com/api/optimize/parib0MC3hVoUNdfQdnac/JFqEhIvwR3btG6Le4P5Kr_enteractivationcode.png" position="flex-start" size="40" initialPath="images/EnterActivationCode.png" githubPath="iPaaS/images/EnterActivationCode.png" width="432" height="319" darkWidth="432" darkHeight="319" showCaption="false" indent="1"}

7. Final step is to test the agent.

:::Paragraph{indent="1"}
A success message is displayed when the agent is successfully tested.
:::

2. Repeat the process to add agents to all the servers.

### Add Connections

Once the group is created and the agent is set up, the next step is to add connections to the agents. For more information, see [Connection](docId:8YqQtgXANuiJxlC5RhEm2).

:::hint{type="info"}
To add a connection, go to **Projects** and add. Do not add from within the On-prem Group.
:::