# On-premise agent installation using DEB Linux package

This guide describes the installation of an on-premise agent using DEB Linux package for operating systems like Debian and Ubuntu.


Ensure that you have sudo privileges to run these commands.

# Step 1: Install On-prem agent


Add the new repository information to the APT config file:

echo 'deb https://workato-public.s3.amazonaws.com/DAA34553/repo/deb stable main' >/etc/apt/sources.list.d/workato.list

Add the Workato GPG public key to apt trusted keys:

% wget -qO - 'https://workato-public.s3.amazonaws.com/DAA34553/repo/archive.key' | sudo apt-key add -

Your new repository is now ready. Update the package cache using the following command:

% sudo apt-get update

Hit:1   jammy InRelease
Get:2   jammy-updates InRelease [109 kB]                       
Get:3   jammy-backports InRelease [99.8 kB]                    
Hit:4 https://workato-public.s3.amazonaws.com/repo/deb stable InRelease                                           
Get:5   jammy-security InRelease [110 kB]                                              
Get:6   jammy-updates/main amd64 Packages [277 kB]
Get:7   jammy-updates/universe amd64 Packages [116 kB]
Get:8   jammy-updates/universe Translation-en [40.1 kB]
Get:9   jammy-updates/universe amd64 c-n-f Metadata [2344 B]
Get:10   jammy-security/universe amd64 c-n-f Metadata [1128 B]
Fetched 756 kB in 1s (1107 kB/s)
Reading package lists... Done

Search for workato. The result lists agents that are using different data centers. Choose an agent that matches your data center location:

% sudo apt-cache search workato

workato-agent - workato-agent
workato-agent-eu - workato-agent-eu
workato-agent-jp - workato-agent-jp
workato-agent-sg - workato-agent-sg
workato-agent-au - workato-agent-au

Install the agent using the following command:

% sudo apt install workato-agent

# Step 2: Activate On-prem agent


Open your On-prem group page and click Add new agent. Provide a meaningful agent name, and select the operating system (OS) for the agent installation.

Choose OS Choose OS


Read and accept the End User License Agreement.

Accept ToS Accept Terms of Service


On running the activation command below, the agent key and certificate will be automatically created in the agent package. The activation code is valid for one hour.

Please note that the traffic to Workato should be allowed from your server - see more information here.

Navigate to <install_home> directory, copy and run the following command from the wizard.


If you're using a proxy, you must add --proxy-host=<host-ip-address> --proxy-port=<port number> parameters to the activation command shown in the wizard.

Activate Activate

# Step 3: Run the On-prem agent


To start the agent service in the background, use:

systemctl start workato-agent.service

To enable the agent to start on system boot use:

systemctl enable workato-agent.service

Open the agent wizard in Workato by clicking Setup Now, and advance to the Test agent step to check if the agent can connect to Workato:


Last updated: 10/19/2023, 2:18:15 PM