---
title: On-premise agent
slug: on-premise-agent
description: Install and use on-premise agents to securely access local applications and databases
image: https://archbee-image-uploads.s3.amazonaws.com/oAyFj2GHlBeBVWF5OAir2/B_8jIyom_s6o7J5Nc_W8u_domino-zoomin-purple-a-1.png
docTags:
createdAt: 2025-02-03T13:29:13.656Z
---
:::hint{type="info"}
This feature is available to Enterprise customers.
:::
With the On-premise agent (On-prem agent) installed on your system, your scenarios can access applications and databases on your local network without changing the settings of your firewall.
One On-prem agent can connect to many applications that are located in the same network. Currently, we provide an [HTTP Agent](https://apps.make.com/http-agent) app that allows for a connection with other custom systems that provide an API or a web service.
To start using an On-prem agent in your scenario, you need to:
1. [Create](docId:2D2-HUt5EUJNKigSzp0vM) a new On-prem agent in the **On-prem agents** section of the **Organization** dashboard.
2. [Download](docId:2D2-HUt5EUJNKigSzp0vM) the On-prem agent and [install](docId:2D2-HUt5EUJNKigSzp0vM) it on your device.
3. [Connect a system](docId:2D2-HUt5EUJNKigSzp0vM) (an application) to the installed On-prem agent.
4. [Create a connection](docId:2D2-HUt5EUJNKigSzp0vM) between Make and the connected system when adding the application module in your scenario.
## Add an On-prem agent
The installation process consists of three steps:
- Create an On-prem agent in the **On-prem Agents** section, in Make.
- Download the On-prem agent to your device.
- Install the On-prem agent on your device.
:::hint{type="info"}
Only users with the **Owner**, **Admin**, and **App dev** organization roles can perform all three steps.
:::
### Create an On-prem agent
To create an On-premise agent:
:::::WorkflowBlock
:::WorkflowBlockItem
In the left sidebar, click **Org**.
:::
:::WorkflowBlockItem
Switch to the **On-prem Agents** tab.
:::
:::WorkflowBlockItem
Click **+ Create on-prem agent**.
:::
:::WorkflowBlockItem
In the **On-prem agent name** field, enter the agent name, and click **Create agent**.
::Image[]{src="https://api.archbee.com/api/optimize/oAyFj2GHlBeBVWF5OAir2/NEZg6CtaynUDJtnus2aWb-20251015-094542.png" size="50" width="884" height="454" position="center" darkWidth="884" darkHeight="454" showCaption="false"}
:::
:::WorkflowBlockItem
A dialog box with credentials appears.
::Image[]{src="https://api.archbee.com/api/optimize/oAyFj2GHlBeBVWF5OAir2/2cUxTR6OysA07nhupXJHU-20251015-094959.png" size="40" width="890" height="1078" position="center" darkWidth="890" darkHeight="1078" showCaption="false"}
:::
::::WorkflowBlockItem
Save the **Client ID**, the **Secret**, and the **Base URL** in a safe place. You will need these credentials in the installation stage later.
:::hint{type="warning"}
Make sure to save the credentials in a secure location. This is the only time when Make shows the On-prem agent credentials.
:::
::::
:::WorkflowBlockItem
Check the **I saved my credentials **box.
:::
:::WorkflowBlockItem
Click **Download installer**.
:::
:::::
Make redirects you to the download page, where you can choose your device OS and [download the On-prem agent installer](docId:2D2-HUt5EUJNKigSzp0vM).
### Download the On-prem agent
To run the On-prem agent on your device, you need to download its installation package:
::::WorkflowBlock
:::WorkflowBlockItem
Once you click **Download installer **as described in step 8 in [Create an On-prem agent](docId:2D2-HUt5EUJNKigSzp0vM) section, you'll be redirected to the installation page. Select your device's operating system and click **Download**.
For macOS, download the file for Linux.
::Image[]{src="https://api.archbee.com/api/optimize/oAyFj2GHlBeBVWF5OAir2/-k6_9qgRdrgAx_jWOmb2v-20251015-095319.png" size="40" width="1794" height="930" position="center" darkWidth="1794" darkHeight="930" showCaption="false"}
If the auto-download doesn't start automatically, use the link instead.
:::
:::WorkflowBlockItem
Define where you want to save the On-prem agent installation package on your device.
:::
:::WorkflowBlockItem
Click **Save**.
:::
::::
### Install the On-prem agent
Installation is the last step you need to start using the On-prem agent in Make. Here you will find steps for installing the On-prem agent on Windows, macOS, and Linux.
:::::ExpandableHeading
### Installation for Windows
:::hint{type="info"}
You need to have Java 11 or above already installed on your device:
:::
::::WorkflowBlock
:::WorkflowBlockItem
Go to the folder where you saved the On-prem agent when downloading, right-click the file, and select **Run as Administrator**. An installation window appears. Click **Install**.
::Image[]{src="https://api.archbee.com/api/optimize/yAufeXqD1oGWOPBNi5MAm-a76EsKwgw5ZN8o0_UwlUp-20250218-105639.png" size="50" width="946" height="587" position="flex-start" alt="Make Agent Installer" showCaption="false"}
You might see a warning. Click **Yes** to continue the installation process.
:::
:::WorkflowBlockItem
Insert the credentials you saved when [creating the On-prem agent](docId:2D2-HUt5EUJNKigSzp0vM) in Make and click **Next**.
::Image[]{src="https://api.archbee.com/api/optimize/yAufeXqD1oGWOPBNi5MAm-kTmrH7Y6SwggpXUws4Pvk-20250218-105901.png" size="50" width="973" height="762" position="flex-start" alt="Insert credentials" showCaption="false"}
:::
:::WorkflowBlockItem
Select the path for installation and click **Next**.
::Image[]{src="https://api.archbee.com/api/optimize/yAufeXqD1oGWOPBNi5MAm-zAyXG0US3MkoDf1a8k2Wi-20250218-110031.png" size="50" width="972" height="748" position="flex-start" alt="Path for installation" showCaption="false"}
:::
:::WorkflowBlockItem
Make sure your internet connection is stable. Click **Install**.
:::
:::WorkflowBlockItem
Complete the installation by clicking **Finish**.
:::
:::WorkflowBlockItem
A confirmation window appears. Click **Close**.
:::
::::
The On-prem agent status changes to **Active** in Make after refreshing the On-prem agents page. You can [connect a system](docId:2D2-HUt5EUJNKigSzp0vM) to it.
You can also check your system to see if the installation was successful:
::::WorkflowBlock
:::WorkflowBlockItem
Open the **Services** app on your computer.
:::
:::WorkflowBlockItem
In the list of services, find **Make Agent**. If the status is **Running**, you can start using the On-prem agent in Make. If there is no status, check the [troubleshooting guide](docId:2D2-HUt5EUJNKigSzp0vM).
:::
::::
:::hint{type="info"}
The installer works only for the agent you've downloaded. If you need to run more than one agent on your server, you need to download the installer once again and repeat the installation procedure.
:::
:::::
:::::ExpandableHeading
### Installation for macOS
:::hint{type="info"}
You need to have Java 11 or above already installed on your device:
:::
::::WorkflowBlock
:::WorkflowBlockItem
Go to the folder where you saved the .zip archive.
:::
:::WorkflowBlockItem
Unzip the archive.
:::
:::WorkflowBlockItem
Open the `application-local.yml` file and fill in the following fields with the data you saved when [adding an On-prem agent](docId:2D2-HUt5EUJNKigSzp0vM) in Make.
- `make: authentication: client-id`
- `make: authentication: client-secret`
- `make: authentication: base-url`
:::
:::WorkflowBlockItem
Save the changes in the file.
:::
:::WorkflowBlockItem
Open the Terminal.
:::
:::WorkflowBlockItem
Open the folder that you unzipped from the archive in the Terminal. It is called **Linux-Mac**.
:::
:::WorkflowBlockItem
Launch the file using this command: `java -jar agent.jar`
:::
::::
The system launches the On-prem agent. If you see the `Successfully connected Agent with ID...` and `Started to poll for tasks` strings, it means the agent is installed successfully. You can connect a system to it.
:::::
:::::ExpandableHeading
### Installation for Linux
:::hint{type="info"}
You need to have Java 11 or above already installed on your device:
:::
::::WorkflowBlock
:::WorkflowBlockItem
Go to the folder where you saved the .zip archive.
:::
:::WorkflowBlockItem
Unzip the archive.
:::
:::WorkflowBlockItem
Copy the `application-example.yml` file, and rename the copied file to `application-local.yml`.
:::
:::WorkflowBlockItem
Open the `application-local.yml` file and fill in the following fields with the data you saved when [adding an On-prem agent](docId:2D2-HUt5EUJNKigSzp0vM) in Make.
- `make: authentication: client-id`
- `make: authentication: client-secret`
- `make: authentication: base-url`
:::
:::WorkflowBlockItem
Save the changes in the file.
:::
:::WorkflowBlockItem
Open the Terminal.
:::
:::WorkflowBlockItem
Open the folder that you unzipped from the archive in the Terminal. It is called **Linux-Mac**.
:::
:::WorkflowBlockItem
Launch the file using this command: `java -jar agent.jar`
:::
::::
The system launches the On-prem agent. If you see the `Successfully connected Agent with ID...` and `Started to poll for tasks` strings, it means the agent is installed successfully. You can connect a system to it.
:::::
## Connect a system
Once you have installed the On-prem agent, you can connect it to an application (a connected system). You can connect several systems to one On-prem agent.
:::hint{type="info"}
Only users with the **Owner**, **Admin**, and **App dev** organization roles can connect a system.
:::
### Connect the HTTP system
:::::WorkflowBlock
:::WorkflowBlockItem
In the left sidebar, click **Organization**.
:::
:::WorkflowBlockItem
Click the **On-prem agents** tab.
:::
:::WorkflowBlockItem
Click **Connect system**.
:::
:::WorkflowBlockItem
In the **Name** field, insert a connection name. This name appears when adding an application module to a Make.
:::
:::WorkflowBlockItem
In the **Choose app to connect** dropdown list, select the [HTTP Agent](https://apps.make.com/http-agent) app.
::Image[]{src="https://api.archbee.com/api/optimize/oAyFj2GHlBeBVWF5OAir2/GCq_Pq73GOybKwqG1PPGS-20260128-141145.png" size="50" width="440" height="518" position="center" darkWidth="440" darkHeight="518" showCaption="false"}
:::
::::WorkflowBlockItem
Define the base URL to the application API.
:::hint{type="info"}
The URL contains a host, a port, and a definition of API for a particular app. If the app runs on the same device where the On-prem agent is installed, the host is `localhost`. If the app runs on another device, the host is the device IP address. The port and the API definition vary based on the app.
In this example URL `https://localhost:3000/api`
- the host is `localhost`
- the port is `3000`
- the definition of API is `/api`
:::
::::
:::WorkflowBlockItem
In the **URL** field, insert the URL to the application API.
:::
:::WorkflowBlockItem
Click **Save**.
:::
:::::
In the connected systems list, you will see a new connection that works with this specific On-prem agent. Now you can start building a scenario.
:::hint{type="info"}
You might be asked to renew the access to the connected system after a certain period of time. If so, click **Revoke** in the **Connected systems** section.
:::
## Create a connection in the scenario
To create a [connection](docId\:SO88FM6pkT0G-adKDDfzZ), go to the Scenario Builder.
::::WorkflowBlock
:::WorkflowBlockItem
Click **Create a new scenario**.
:::
:::WorkflowBlockItem
Select the **HTTP Agent** from the dropdown list.
:::
:::WorkflowBlockItem
Select a module and connect it to Make.
:::
:::WorkflowBlockItem
Finish configuring the module settings.
:::
::::
After adding the module, you can continue building your scenario. The module uses your selected On-prem agent.
:::hint{type="info"}
Currently, Make supports only **HTTP Agent** application for the On-prem agent usage.
:::
## On-prem agent status
The following table explains On-prem agent statuses.
| **Status** | **Description** | **Recommended next steps** |
| ------------------ | --------------------------------------------------------------------------------------------------------------------------------------------------------------- | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| **Active** | The On-prem agent is installed on your device and works under normal conditions. You can connect a system to it and use it in scenarios. | |
| **Not responding** | The On-prem agent is disconnected. Make checks its activity every four minutes. If the On-prem agent doesn't respond, it means the Internet connection is lost. | Check [On-prem agent troubleshooting](#).
When in Not responding status, associated scenarios still run, but the module using the On-prem agent shows a **500 error.** |
| **Registered** | The On-prem agent is created and appears in the **On-prem agents** section. | - Make sure to complete the installation of the On-prem agent.
- Check if your firewall or anti-virus software is blocking the On-prem agent. |
| **Stopped** | The On-prem agent was stopped manually. | Make your On-prem agent active again if needed. |
## Troubleshooting
Here you can find solutions for the most common issues when working with the On-prem agent in Make.
:::ExpandableHeading
### Windows installer broke in the middle of the installation
If the installation process breaks, and the progress bar remains the same, do the following:
1. Check if you have these drives installed and updated:
a. Visual Studio 2019
b. AdoptOpenJDK 11
c. Java 11 and above
2. Restart the installation process.
:::
:::ExpandableHeading
### Error regarding wrong Java version when installing the On-prem agent for Windows
The following error appears if you have the wrong version of Java installed on your device:
1. Open the Command line.
2. Use the `echo %JAVA_HOME%` command to make sure Java is in the Windows PATH variable.
3. Use the `java -version` command to make sure Java 11 or above is installed.
:::
:::ExpandableHeading
### No permissions to run the Windows installer
Right-click the installer and click **Run as Administrator**.
:::
:::ExpandableHeading
### On-prem agent in Not responding status in Make
Check the following:
- The device where the On-prem agent is installed is operational.
- The device is connected to the Internet.
- The Internet connection is stable.
- Your firewall and anti-virus software don't block the On-prem agent.
- Restart the On-prem agent on your device (Windows only):
:::
:::ExpandableHeading
### On-prem agent not running on a Windows machine
If you open the **Services** app on Windows and see that the **Make Agent** app doesn't have the **Running** status, you can do the following:
1. Go to the folder where you saved the On-prem agent on your machine.
2. Open the **application-local** file and check your credentials: Client ID, Secret, and Base URL.
3. Open the **logs** folder and locate the problem.
:::