ArchitectArchitect

Installing an Architect Agent

February 4, 2026|

**Beta version downloads are available through Discord

discord.cftools.cloud**

Any Agent installation requires a license key

License keys are valid for a certain amount of Agent installations. For details, check your purchase confirmation.

Prior to any installation, please check the system requirements.

Some providers require specific system settings for the Agent to function correctly, you can review these here.

Windows

On Windows, Architect Toolbox is the recommended way to install and manage the Agent. It installs the Agent as a Windows service, stays in the system tray, and lets you start, stop, update, and repair the service.

**Beta version downloads are available through Discord

discord.cftools.cloud**

Full non-arbitrarily restricted administrator privileges are required on the system.

Video Walkthrough: https://www.youtube.com/watch?v=7cre0XxOaiM

Installation through automated installer

  • Download installer through your CFTools Cloud account
  • Execute installer
  • Enter license key
  • Finalize installation
  • Perform base configuration
  • Verify firewall rules are set for your Agent port (TCP, inbound and outbound)
  • Retrieve `root` user password, from agent installation directory from `root.txt` file

Manual Installation

Advanced topic, installation through installer is recommended

  • Create directory structure where you want to install your Agent

  • Download executable through your CFTools account

  • Move executable to installation directory

  • Create config.toml alongside executable (config.toml format)

  • Start command prompt (CMD/Bash) as Administrator

  • Install agent as Windows service through the command

    ArchitectAgent.exe --mode install
    

Linux

**Beta version downloads are available through Discord

discord.cftools.cloud**

ARM is not supported

List of supported Linux distros: System requirements

All steps must be executed as root user.

Installation via systemd/systemctl

  • Download installer through your CFTools Cloud account
  • Execute installer
  • Enter license key
  • Finalize installation
  • Perform base configuration
  • Verify firewall rules are set for your Agent port (TCP, inbound and outbound)
  • Retrieve `root` user password, from agent installation directory from `root.txt` file

Installation via Docker

Prerequisites:

  • Functional Docker installation

Docker image is not provided during beta period.

Was this article helpful?
Back to Architect