---
title: "How to: Create On-Prem Agents Using the Integration Gateway"
slug: "how-to-create-on-prem-agents-using-the-integration-gateway"
updated: 2025-09-25T19:49:23Z
published: 2025-09-25T19:49:23Z
canonical: "docs.unqork.io/how-to-create-on-prem-agents-using-the-integration-gateway"
---

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

# How to: Create On-Prem Agents Using the Integration Gateway

## Overview

The **Integration Gateway** lets you integrate with over 700 systems across enterprise [applications](/v1/docs/introduction-to-unqork-applications), databases, and legacy on-premise infrastructure—in the cloud or on-premise. To integrate with on-premise (or on-prem) systems, you must create an On-Prem Group in the Integration Gateway. From there, you can create an On-Prem Agent, download it locally, activate it, and test it.

> [!TIP]
> To learn how to access the Integration Gateway, view our [Integration Administration](/v1/docs/adm-intro-integration-administration) article.

## What You'll Learn

In this article, you'll learn how to create an On-Prem Group, On-Prem Agent, and activate and test it.

## Creating an On-Prem Group Using Integration Gateway

After accessing the Integration Gateway, you'll use the **On-Prem Groups** tab to create an On-Prem Group. After creating your group, you can set up, activate, test, and store as many agents as you want. From this tab, you can also view and select existing on-prem groups in your environment.

[![A static image displaying the selection of the On Prem Groups tab in the Integrations Gateway.](https://cdn.us.document360.io/15548f06-2fba-434c-b0c1-5df88317dbd7/Images/Documentation/IntGateway_OnPremGroup_thumb_0_0.jpg?sv=2026-02-06&spr=https&st=2026-11-08T18%3A05%3A09Z&se=2026-11-08T19%3A05%3A09Z&sr=c&sp=r&sig=a24FthqT2tLQYbxbDe3IvNWT2QINSzbXh3jbniwiEoQ%3D)](https://cdn.us.document360.io/15548f06-2fba-434c-b0c1-5df88317dbd7/Images/Documentation/IntGateway%20OnPremGroup.jpg?sv=2026-02-06&spr=https&st=2026-11-08T18%3A05%3A09Z&se=2026-11-08T19%3A05%3A09Z&sr=c&sp=r&sig=a24FthqT2tLQYbxbDe3IvNWT2QINSzbXh3jbniwiEoQ%3D)

To create an On-Prem Group:

1. Navigate to the **On-Prem Groups** tab.
2. Click the **+ New Group** tile. The New On-Prem Group modal displays.
3. In the **Group Name*** field, enter a name for your On-Prem Group.

[![A static image displaying the New On-Prem Group modal to create an On-Prem Group in the Integrations Gateway.](https://cdn.us.document360.io/15548f06-2fba-434c-b0c1-5df88317dbd7/Images/Documentation/IntGateway_CreateGroup_thumb_0_0.jpg?sv=2026-02-06&spr=https&st=2026-11-08T18%3A05%3A09Z&se=2026-11-08T19%3A05%3A09Z&sr=c&sp=r&sig=a24FthqT2tLQYbxbDe3IvNWT2QINSzbXh3jbniwiEoQ%3D)](https://cdn.us.document360.io/15548f06-2fba-434c-b0c1-5df88317dbd7/Images/Documentation/IntGateway%20CreateGroup.jpg?sv=2026-02-06&spr=https&st=2026-11-08T18%3A05%3A09Z&se=2026-11-08T19%3A05%3A09Z&sr=c&sp=r&sig=a24FthqT2tLQYbxbDe3IvNWT2QINSzbXh3jbniwiEoQ%3D)
4. Click **Create Group**.

## Creating an On-Prem Agent Using Integration Gateway

After creating your On-Prem Group, you can begin setting up your On-Prem Agents. The process lets you select your operating system, download the agent installer, then activate and test the agent. The various steps involved depend on the operating system you choose. The steps required to create your On-Prem Agent are the following for each operating system:

#### Windows

1. Choose OS (Operating System)
2. Accept ToS (Terms of Service)
3. Install Agent (`.exe` file format)
4. Activate and Run Agent
5. Test Agent

#### Linux

1. Choose OS (Operating System)
2. Accept ToS (Terms of Service)
3. Install Agent
4. Activate Agent
5. Run Agent
6. Test Agent

#### Mac

1. Choose OS (Operating System)
2. Accept ToS (Terms of Service)
3. Download Agent (`.tar.gz` file format)
4. Activate Agent
5. Run Agent
6. Test Agent

#### Docker

1. Choose OS (Operating System)
2. Accept ToS (Terms of Service)
3. Pull the Agent
4. Activate and Run Agent
5. Test Agent

### Choose OS (Operating System)

The first step is to name your On-Prem Agent and select an operating system. For this example, we'll follow the steps necessary to set up an On-Prem Agent using the **Windows** operating system.

To create, name, and select an operating system for your On-Prem Agent:

1. Click **Add On-Prem Agent**. The Add Agent modal displays..

[![A static image displaying the Add On-Prem Agent button to create an On-Prem Agent in your On-Prem Group.](https://cdn.us.document360.io/15548f06-2fba-434c-b0c1-5df88317dbd7/Images/Documentation/IntGateway_Add_thumb_0_0.jpg?sv=2026-02-06&spr=https&st=2026-11-08T18%3A05%3A09Z&se=2026-11-08T19%3A05%3A09Z&sr=c&sp=r&sig=a24FthqT2tLQYbxbDe3IvNWT2QINSzbXh3jbniwiEoQ%3D)](https://cdn.us.document360.io/15548f06-2fba-434c-b0c1-5df88317dbd7/Images/Documentation/IntGateway%20Add.jpg?sv=2026-02-06&spr=https&st=2026-11-08T18%3A05%3A09Z&se=2026-11-08T19%3A05%3A09Z&sr=c&sp=r&sig=a24FthqT2tLQYbxbDe3IvNWT2QINSzbXh3jbniwiEoQ%3D)

> [!TIP]
> If you already have an existing On-Prem Group, access it and click **Add Agent** at the top right of the page.
2. In the **Agent Name*** field, enter a name for your On-Prem Agent.
3. From the **Operating System*** drop-down, select your computer's operating system.

[![A static image displaying the Choose OS options for creating an On-Prem Agent using the Integrations Gateway.](https://cdn.us.document360.io/15548f06-2fba-434c-b0c1-5df88317dbd7/Images/Documentation/IntGateway_ChooseOS_thumb_0_0.jpg?sv=2026-02-06&spr=https&st=2026-11-08T18%3A05%3A09Z&se=2026-11-08T19%3A05%3A09Z&sr=c&sp=r&sig=a24FthqT2tLQYbxbDe3IvNWT2QINSzbXh3jbniwiEoQ%3D)](https://cdn.us.document360.io/15548f06-2fba-434c-b0c1-5df88317dbd7/Images/Documentation/IntGateway%20ChooseOS.jpg?sv=2026-02-06&spr=https&st=2026-11-08T18%3A05%3A09Z&se=2026-11-08T19%3A05%3A09Z&sr=c&sp=r&sig=a24FthqT2tLQYbxbDe3IvNWT2QINSzbXh3jbniwiEoQ%3D)

> [!NOTE]
> When selecting the Linux operating system, a new drop-down displays in the modal. Use this drop-down to select which agent package format you want to use for installation. The options include DEB package, RPM package, or TGZ archive.
4. Click **Next**.

### Accept ToS (Terms of Service)

The next step is to accept the terms of service for your On-Prem Agent. If you accept the terms, select ![](https://cdn.us.document360.io/15548f06-2fba-434c-b0c1-5df88317dbd7/Images/Documentation/Checked_Box_Blue(2).png?sv=2026-02-06&spr=https&st=2026-11-08T18%3A05%3A09Z&se=2026-11-08T19%3A05%3A09Z&sr=c&sp=r&sig=a24FthqT2tLQYbxbDe3IvNWT2QINSzbXh3jbniwiEoQ%3D) **I have read and agree to the above End User License Agreement** at the bottom of the modal. Then, click **Next**.

[![A static image displaying the acceptance checkbox of the terms of service to create the On-Prem Agent.](https://cdn.us.document360.io/15548f06-2fba-434c-b0c1-5df88317dbd7/Images/Documentation/IntGateway_AcceptToS_thumb_0_0.jpg?sv=2026-02-06&spr=https&st=2026-11-08T18%3A05%3A09Z&se=2026-11-08T19%3A05%3A09Z&sr=c&sp=r&sig=a24FthqT2tLQYbxbDe3IvNWT2QINSzbXh3jbniwiEoQ%3D)](https://cdn.us.document360.io/15548f06-2fba-434c-b0c1-5df88317dbd7/Images/Documentation/IntGateway%20AcceptToS.jpg?sv=2026-02-06&spr=https&st=2026-11-08T18%3A05%3A09Z&se=2026-11-08T19%3A05%3A09Z&sr=c&sp=r&sig=a24FthqT2tLQYbxbDe3IvNWT2QINSzbXh3jbniwiEoQ%3D)

### Install Agent

In the next step, click **Download Installer** to download the agent. After the download is complete, install it on your computer. You'll be prompted to complete the installation through an installation wizard. As you progress through the installation wizard, you will be asked to provide an activation code. Click **Next** in the Add Agent modal to display the code.

[![A static image displaying the option to download the installer onto your computer.](https://cdn.us.document360.io/15548f06-2fba-434c-b0c1-5df88317dbd7/Images/Documentation/IntGateway_Download_thumb_0_0.jpg?sv=2026-02-06&spr=https&st=2026-11-08T18%3A05%3A09Z&se=2026-11-08T19%3A05%3A09Z&sr=c&sp=r&sig=a24FthqT2tLQYbxbDe3IvNWT2QINSzbXh3jbniwiEoQ%3D)](https://cdn.us.document360.io/15548f06-2fba-434c-b0c1-5df88317dbd7/Images/Documentation/IntGateway%20Download.jpg?sv=2026-02-06&spr=https&st=2026-11-08T18%3A05%3A09Z&se=2026-11-08T19%3A05%3A09Z&sr=c&sp=r&sig=a24FthqT2tLQYbxbDe3IvNWT2QINSzbXh3jbniwiEoQ%3D)

> [!WARNING]
> To activate and run the On-Prem Agent, your server must have permission to allow traffic between it and the Integration Gateway. To learn more, view the following documentation: ![](https://cdn.us.document360.io/15548f06-2fba-434c-b0c1-5df88317dbd7/Images/Documentation/link_out_icon(10).png?sv=2026-02-06&spr=https&st=2026-11-08T18%3A05%3A09Z&se=2026-11-08T19%3A05%3A09Z&sr=c&sp=r&sig=a24FthqT2tLQYbxbDe3IvNWT2QINSzbXh3jbniwiEoQ%3D) [https://docs.workato.com/security/ip-allowlists.html#traffic-from-workato](https://docs.workato.com/security/ip-allowlists.html#traffic-from-workato).

### Activate and Run Agent

This step of the Add Agent modal displays the activation code you must enter into the installation wizard. Click ![](https://cdn.us.document360.io/15548f06-2fba-434c-b0c1-5df88317dbd7/Images/Documentation/integration_gateway_copy_icon.png?sv=2026-02-06&spr=https&st=2026-11-08T18%3A05%3A09Z&se=2026-11-08T19%3A05%3A09Z&sr=c&sp=r&sig=a24FthqT2tLQYbxbDe3IvNWT2QINSzbXh3jbniwiEoQ%3D) Copy to copy the code to your clipboard. Then, paste it into the required field of the installation wizard.

Once the installation is complete, your On-Prem Agent is activated and runs automatically. Click **Next** in the Add Agent modal to proceed.

> [!WARNING]
> The activation code expires in one hour. If it expires, click ![](https://cdn.us.document360.io/15548f06-2fba-434c-b0c1-5df88317dbd7/Images/Documentation/integration_gateway_generate_icon.png?sv=2026-02-06&spr=https&st=2026-11-08T18%3A05%3A09Z&se=2026-11-08T19%3A05%3A09Z&sr=c&sp=r&sig=a24FthqT2tLQYbxbDe3IvNWT2QINSzbXh3jbniwiEoQ%3D) **Regenerate Code** to generate a new one.

[![A static image display the activation code you must copy and paste into the installation wizard to complete the activation of your On-Prem Agent.](https://cdn.us.document360.io/15548f06-2fba-434c-b0c1-5df88317dbd7/Images/Documentation/IntGateway_ActivateRun_thumb_0_0.jpg?sv=2026-02-06&spr=https&st=2026-11-08T18%3A05%3A09Z&se=2026-11-08T19%3A05%3A09Z&sr=c&sp=r&sig=a24FthqT2tLQYbxbDe3IvNWT2QINSzbXh3jbniwiEoQ%3D)](https://cdn.us.document360.io/15548f06-2fba-434c-b0c1-5df88317dbd7/Images/Documentation/IntGateway%20ActivateRun.jpg?sv=2026-02-06&spr=https&st=2026-11-08T18%3A05%3A09Z&se=2026-11-08T19%3A05%3A09Z&sr=c&sp=r&sig=a24FthqT2tLQYbxbDe3IvNWT2QINSzbXh3jbniwiEoQ%3D)

### Test Agent

Now that your On-Prem Agent is activated and running, test it to ensure it works correctly. In this final step of the process, click **Test Agent**. After you receive confirmation it's working correctly, click **Done**. You'll return to your On-Prem Group where you can repeat the process to set up another On-Prem Agent.

[![A static image displaying the final test step of the process to ensure your On-Prem Agent was successfully installed, activated, and running.](https://cdn.us.document360.io/15548f06-2fba-434c-b0c1-5df88317dbd7/Images/Documentation/IntGateway_Test_thumb_0_0.jpg?sv=2026-02-06&spr=https&st=2026-11-08T18%3A05%3A09Z&se=2026-11-08T19%3A05%3A09Z&sr=c&sp=r&sig=a24FthqT2tLQYbxbDe3IvNWT2QINSzbXh3jbniwiEoQ%3D)](https://cdn.us.document360.io/15548f06-2fba-434c-b0c1-5df88317dbd7/Images/Documentation/IntGateway%20Test.jpg?sv=2026-02-06&spr=https&st=2026-11-08T18%3A05%3A09Z&se=2026-11-08T19%3A05%3A09Z&sr=c&sp=r&sig=a24FthqT2tLQYbxbDe3IvNWT2QINSzbXh3jbniwiEoQ%3D)

## Resources

- [Learn more about APIs.](/v1/docs/apis-connecting-your-apps)
- [Learn how APIs work](/v1/docs/how-do-apis-work).
- [Integration Administration](/v1/docs/adm-intro-integration-administration).
- [How to: Create Connections and Recipes Using the Integration Gateway](/v1/docs/how-to-create-connections-and-recipes-using-the-integration-gateway).
- [How to: Promote Recipes Using the Integration Gateway](/v1/docs/how-to-promote-recipes-using-the-integration-gateway).
- [How to: Get Salesforce Contact Records](/v1/docs/how-to-get-salesforce-contact-records).
- [How to: Create Salesforce Contact Records](/v1/docs/how-to-create-salesforce-contact-records).

A modal is a window that appears on top of the content you are currently viewing.

A place on your operating system that stores recently copied content. The clipboard only stores one item at a time.