Note
Required: You must update your on-premise agent to version 5.7.1. Agents not updated may lose connectivity to the Celigo platform.
To keep your integrations running, download and install the latest on-premise agent from integrator.io. This article walks you through the full update process, including how to verify the update and what to do if you have multiple agents. The update takes 10–15 minutes and requires administrator access on the machine where your agent is installed.
-
Time required: 10–15 minutes
-
Who should do this: The person with access to the machine where the agent is installed — typically an IT administrator
-
What you’ll need: Login credentials for your Celigo account and administrator access on the agent host machine
-
Sign in to integrator.io.
-
Go to Resources > On-premise agents.
-
Find your agent in the list and note the version number.
If your agent is already on v5.7.1, no action is needed.
-
In Resources > On-premise agents, select Show token next to your agent.
-
Select the copy icon next to the token to copy it to your clipboard.
-
Save this token somewhere safe — you will need it after the install.
If your agent runs on a different machine than the one you’re using, transfer the installer to that machine before continuing.
-
On the machine running your agent, run the downloaded installer.
-
Follow the installation prompts.
-
If prompted for your agent access token, enter the token you saved in Step 2.
-
Wait for the installation to complete.
If your account has more than one on-premise agent, update them one at a time:
-
Update the first agent following the steps above.
-
Wait a few minutes and confirm it is online and showing v5.7.1.
-
Proceed to update the next agent.
Do not update all agents simultaneously.
For more in-depth questions, create a support ticket.
How are you pushing this upgrade when the on-premise agent runs behind our firewall? Does Celigo have a backdoor to my system?
Celigo has no way to access your system. This update is possible because active agents look for the latest agent in a GitHub repository. Once the latest agent software is placed in the repository, the active agent picks up the latest update.
Your integrations will pause briefly while the agent restarts after the install (approximately 10–30 seconds). Queued work is preserved and resumes automatically once the agent is back online.
No. All your agent settings, registered connections, and tokens are preserved during the update. Only the agent runtime is updated.
No. The installer updates your existing agent installation in place. You do not need to uninstall the old version first.
If the installer does not complete successfully:
-
Contact Celigo support at support@celigo.com or the priority contact provided in the update notification.
-
Be prepared to provide your agent name, the error message (if any), and your operating system version.
-
Celigo support will assist you with recovery, including providing the previous agent version if needed.
Do not attempt to uninstall or reinstall without guidance from Celigo support.
-
Windows: Press
Win + R, typewinver, and press Enter. -
Linux: Open a terminal and run
lsb_release -aorcat /etc/os-release.
Yes. Since you are performing the update manually, you can choose when to run the installer. Schedule it during a low-traffic window for your integrations — the downtime is minimal (approximately 10–30 seconds).
This is a required update for security and platform compatibility. If you have a specific concern that prevents you from updating, contact your Customer Success Manager or Celigo support to discuss.