Enable auto-update for self-hosted agent deployments
Enable automatic agent updates using the agent.agent_version Helm value. Auto-update ensures agents always run the latest version, with the newest features and fixes applied automatically. If you still wish to update manually, you can set a dedicated version.
For organizations onboarded after June 9, 2026, auto-update is enabled by default.
No action is required.
Process
Reinstall the agent helm chart:
- Add
--set agent.agent_version=auto-update \ - Remove
agent.image.tag
Other
agent.agent_versionvalues are:
latest-on-restart: The agent is upgraded to the latest version when the agent restarts. You can restart manually to push the latest version.- Specific agent version. For example,
2.7.4: Locks the agent to a specific version.
Unsupported Helm value combinationsDo not combine the following
agent.image.tagandagent.agent_versionvalues:
agent.image.tagagent.agent_versionAny value other than latest-on-restartauto-updateAny value other than latest-on-restartlatest-on-restartA pinned version that does not match the pinned version on agent.agent_version
