CFTools
ArchitectArchitect

Updating an Architect Agent

October 6, 2026|

Use Toolbox on Windows when it offers an Agent update. The steps below are the manual fallback when the Agent is not updated automatically.

Windows

Toolbox

Open Architect Toolbox from the system tray. When a newer Agent version is available, Update appears on the dashboard. Apply it from there. Toolbox stops the service, replaces the binary, and starts it again.

See Architect Toolbox.

Manual replacement

  • Download the new ArchitectAgent.exe
  • Stop the ArchitectAgent Windows service
  • Open the Agent installation directory
  • Replace the existing ArchitectAgent.exe with the newer version
  • Start the ArchitectAgent service

Linux

  • Download the new ArchitectAgent binary
  • Stop the service
systemctl stop architect-agent
  • Open the Agent installation directory
  • Replace the existing ArchitectAgent binary with the newer version
  • Start the service
systemctl start architect-agent
Was this article helpful?
Back to Architect
Previous
Moving an Agent installation
Next
Windows Interactive Processes

Related Articles

Frequently asked questions

Common questions about connecting Manager to an Agent, console windows, OmegaManager migration, ports, RCon, and the cache directory.

Moving an Agent installation

Depending on requirement, you may not require to move the entire installation, it is possible to change the locations of the following directories:

Windows Interactive Processes

This information applies to Windows only