Architect
ArchitectEverything revolving around CFTools Architect and Architect Manager
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:
Updating an Architect Agent
Update Architect Agent from Toolbox on Windows, or replace the binary manually when an automatic update is not available.
Windows Interactive Processes
This information applies to Windows only
Reset Root Password
Reset the Architect Agent root password with --reset-root. The new password is written to root.txt.
Optimizing Steam download speed
Architect Agent ships with default download settings that work straight out of the box on any supported hardware configuration. If your system exceeds the minim
Hosting providers
Should your hosting provider **not** be listed, it is assumed that no special considerations need to be taken into account.
Moving individual deployments
If you only need to place specific game server deployments on another drive, you do not need to move the entire Agent installation or the full deployments folder.
Agent firewall entries
Open TCP for the Agent listen port and allow the Agent to reach CFTools hostnames. Addresses are not static.
System requirements
These are the system requirements and recommendations for Architect Agent.
Title and mod cache
Architect downloads all files on-demand and caches the latest up-to-date version locally.
Configuration
Agent settings live in config.toml and are loaded at startup. This page lists the defaults and the keys you can change.
Installing an Architect Agent
Install Architect Agent on Windows with Toolbox, or on Linux with the systemd installer. A license key is required.
Russia specific issues
In Russia, set Architect Manager to the Russia operating region so mod lists and updates use gw-architect.cftools.ru.
Architect Toolbox
Architect Toolbox is the Windows installer and tray manager for Architect Agent. Use it to install, start, stop, update, and repair the Agent service.
Enable Agent stdout feed
Make sure that the user you are using is either \`root\` or you have the appropriate permissions \`agent.enable\_stdout\`, otherwise the stdout feed will remain
Regions
Russia uses the Russia content host. China uses Steam China and requires the Steam plugin.
System status display
System status display is dependent on each agent individually. Depending on your region, specific entries might differ from agent to agent, particularly the sta
Download Progress
The Manager is able to display the current status of all active downloads.
User spaces
Architect allows you to create **user spaces** (US). These user spaces are implemented as OS-native user accounts with their own home directory and folder struc
Windows specifics
This page only relates to Windows operating systems
Audit Logs
The agent archives all actions performed by every user in an audit log. By default, all actions of 30 days are recorded (configurable in config.toml).
Server process configuration
All server process settings can be managed through Settings.
Backup Management
Architect offers automated backup management with integrated options to create, manage and restore backups. Backups work on a static configuration for each indi
Agent Shell
The RPC console in Manager sends raw JSON actions to the connected Agent. It is available to the root user from Dashboard, Tools.
How backups work
This article explains how Architect Agent creates, stores, lists and restores server backups, including size implications, scheduling options and Windows VSS.
File manager
Using Architect, you can remotely manage server files. You can upload, delete, rename, view, download and edit files.
WebHooks
Architect supports WebHooks for different events. You are able to send fully customizable payload structures to any specified URL.
Multi-User and RBAC
Architect supports multiple users in parallel combined with role base access control.
Queue Priority
DayZ queue priority and queue grace are configured per server under Settings, Features.
Shutdown notifications
Architect supports server notifications for different types of shutdowns:
Game Server Metrics
Architect Agent collects CPU and memory for each running game server, plus player counts when the title exposes them.
Modding support
Some information might change depending on how different games handle modding.
Lifecycle Hooks
Architect Agent supports a system to execute custom scripts at certain steps during a game servers lifecycle.
Lifecycle Hooks and Windows SYSTEM Account
Lifecycle hook scripts on Windows run as the SYSTEM account, not as your user. This causes issues with PATH, environment variables and tool availability.
SCUM
_No additional dependencies._
Squad
Squad is split into two branches, separately tracked by Architect.
ArmA Reforger
Arma Reforger public and experimental servers are supported on Windows and Linux. Mods come from the Arma Platform.
Rust
_No additional dependencies._
DayZ
DayZ is split into two Steam applications, separately tracked by Architect.
Health Check HTTP
Similar to the WebSocket API, the Agent exposes a plain HTTP interface on its listening port. You can contact it through either HTTP or HTTPS depending on your
Basics
The Architect Agent comes with an integrated WebSocket API. The API is used by Architect Manager internally and may be accessed by you through custom scripts.
Architect Foundation platform
**CFTools Architect Foundation is a platform solution for large-scale, professional game server management environments.**
Getting started
CFTools Architect is a **centralized server management platform** designed to manage, deploy, and automate game servers at scale. It replaces traditional single
CFTools Architect
CFTools Architect offers an enhanced method for overseeing your computing resources and managing game server deployments.
Title Support
Game titles Architect Agent can deploy, with links to each title page.
Networking requirements
Hostnames Architect Manager and Architect Agent need to reach. IP addresses are not static.
Migrating from OmegaManager
To start your migration from OmegaManager to Architect, you first need to install Architect and be able to access Architect Manager with your agent(s) connected
OmegaManager
OmegaManager is deprecated and has been replaced with CFTools Architect. No support is provided for new OmegaManager installations.
ARK Survival Evolved
ARK Survival Evolved dedicated servers run on Windows and Linux. Manager includes a key-value config editor and no Mods tab.
ARK Survival Ascended
ARK Survival Ascended dedicated servers run on Windows. Manager includes a key-value config editor and no Mods tab.
Valheim
Valheim dedicated servers run on Windows and Linux. Linux installs extra packages. There is a log stream and no Mods or Configuration tab.
Palworld
Palworld dedicated servers run on Windows and Linux. Steam Workshop mods and a key-value config editor are available.
7 Days to Die
7 Days to Die dedicated servers run on Windows and Linux, with a config editor, Telnet RCon, and Unity launch parameters. There is no Mods tab.
Enshrouded
Enshrouded dedicated servers run on Windows. There is no Mods tab and no RCon.
Windrose
Windrose dedicated servers run on Windows. The game port is required. There is no Mods tab, query port, or RCon.
Project Zomboid
Project Zomboid public and unstable servers run on Windows and Linux. Both need a Windows interactive process. Mods and config hot reload are available.
Operating region
Choose World or Russia on first launch. The region selects which host Manager and the Agent use for content.
Scheduled tasks
Create, schedule, and enable scripts from Agent Settings. Review each run in the execution history.
Firewall rules
Root users can create host firewall rules from Agent Settings when the firewall feature is enabled and the Agent is 1.1.45 or newer.
Steam CDN
Review available and excluded Steam content servers from Agent Settings. Requires root.internals and Agent 1.1.40 or newer.
Server maintenance
Rebuild, restore, export, wipe, clear mods, and clear logs from the Maintenance tab. Most actions require a stopped server.
Storage wipe
Schedule a DayZ or Rust storage wipe, or run the same saved configuration from Maintenance.
Server health
DayZ can watch server ports and classify crash files. Other titles do not run these checks while their feature flags stay off.
Game configuration
Edit a server configuration from the Configuration tab. Hot reload is offered only for Project Zomboid.
Manager settings
Lock Manager with a PIN, import and export Agent connections, and sign in to CFTools.
Control Center
See servers from every paired Agent in one grid or list, and start, stop, restart, or kill a server from that view.
Download system
Insights about the Agents download system
Steam plugin
Install the Steam plugin from System, Settings, then enable it in config.toml and sign in under Steam.
Windows Operations
Architect Agent specifics for Windows
Game Server Crashing
Your game server is crashing. Unfortunate, but it can be fixed.
MCP
Experimental MCP endpoint on the Agent at /mcp. Enable it in config.toml and issue a per-user bearer token.
Architect Manager Web
Experimental Architect Manager in the browser at web.gameserver.cloud.