Installing the agent

Installing the agent on Windows

Get the Windows package or the one-line install command from the console, install the host agent as the "AcTree Node" service, and approve the host.

Windows agent

A Windows x86_64 host agent ships with every release (release 0.4.5 at the time of writing), next to the Linux and macOS packages, under the same release signature that the console verifies before it publishes a build. Windows Server 2022 and 2025 x64 run it natively; Windows 11 on ARM runs the x64 runtime under Windows emulation, and the host and process architectures are recorded separately in the console.

From the console open Downloads. For one machine, use Enroll a host and copy the Windows install command: it is valid for 24 hours and enrols a single host. For an estate, create the reusable Fleet bundle — Windows + Linux: one package for every machine, valid for 30 days up to the fleet capacity you set; each machine creates its own identity and stays individually selectable. Run the command or installer in an administrator PowerShell. It downloads the matching build, verifies its signature and SHA-256, and registers the AcTree Node Windows service.

The host then appears under Hosts as pending. A workspace administrator approves it and chooses its command mode: No commands (reports only), Ask (a person approves every command) or Automatic (runs within policy). Revoke the enrollment campaign once the rollout is complete.

A per-user package that needs no administrator rights (the AcTree Host role: installs under the signed-in user’s profile, starts at login, opens no inbound port) ships with release 0.4.5 and is published in the hosted console: Downloads lists Windows x86_64 — per-user, and Enroll a host → Windows — no administrator required produces the workspace bundle (a ZIP with enrollment.json and the installer). The bundle’s Install-HostAgent.cmd checks the installer’s publisher signature first; until the publisher certificate is in place it stops there, so install from the extracted folder with actree-agent-0.4.5-windows-user-x86_64.exe /S /ENROLLMENT=enrollment.json. The computer then appears under Hosts as an AcTree Host for that user, and the Personal Cabinet works with it. Linux and macOS follow agent-install-linux and agent-install-macos.

All documentation

Ask AcTree