# Add Agent to Group

New on-prem group New on-prem group

Once you have selected an on-prem group or created a new one, you will then be prompted to create an agent.

Clicking on Add on-prem agent will bring you through an agent creation wizard to setup, run, and verify that your agent is active. The wizard will take you through the following steps.

# On-premise agent setup wizard

For this example, we will setup an on-prem agent on a Windows OS.

Step Description
Choose OS Provide a meaningful agent name and select the OS in which the agent will be installed.

Choose OS
Accept ToS Read and accept the End User License Agreement.

Accept ToS
Install Download the installer file on the on-prem system. Instructions specific to your OS will be displayed.

Add key Download agent key and move it into the appropriate folder in the agent directory according to the instructions provided.

Add key
Run agent Follow the instructions to setup and run the agent.

Run agent
Test Once the agent is active, click Test to verify that the connection is successful.


# Optional settings on Linux

The following settings assume that the contents of Workato OPA is in /opt/workato

# Setup Workato user

You can to create a non-privileged user to run Workato OPA.

$ groupadd -r workato
$ useradd -c "Workato On-Premise Agent" -g workato -s /sbin/nologin -r -d /opt/workato workato

# Setup systemd service

You can create a systemd service that starts Workato OPA automatically. This prevents disruptions to your critical workflows after system reboots.

  1. Create a systemd service.
$ sudo cat > /lib/systemd/system/workato.service <<EOF
# Systemd unit file for default Workato On-Premise Agent
# To create clones of this service:
# DO NOTHING, use workato@.service instead.

Description=Workato On-Premise Agent
After=syslog.target network.target

ExecStart=/usr/bin/java -Djava.security.egd=file:/dev/urandom -cp "/opt/workato/lib/*" com.workato.agent.Main

  1. Launch Workato OPA and set it to autostart
$ systemctl start workato
$ systemctl enable workato

Learn more about how to setup an on-prem agent here.