The FlowTux agent is a lightweight background service (~15MB). It runs silently, uses minimal resources, and communicates with app.flowtux.com over HTTPS and WSS.

Requirements

Windows: Windows 10 or later, 64-bit

Mac: macOS 11 (Big Sur) or later

Linux: Ubuntu 20.04+, Debian 10+, or equivalent

Download

The agent is part of the Pro plan, and is included for the length of a free trial. Sign in and open Settings → Agent Download to get the build for your OS. Workspace admins can download it; if you are not one, ask an admin on your workspace.

Installing the agent on a workspace below Pro will not work — it refuses to register, and after a trial ends installed agents stay in your fleet but stop running commands until you upgrade.

Windows install

1. Download flowtux-agent.exe
2. Double-click to run
3. Enter your API key (Settings -> API Keys)
4. The agent installs as a Windows Service and starts automatically

Mac install

chmod +x flowtux-agent-mac
./flowtux-agent-mac --install

Enter your API key when prompted. The agent registers as a launchd service.

Linux install

chmod +x flowtux-agent-linux
sudo ./flowtux-agent-linux --install

Enter your API key when prompted. The agent registers as a systemd service.

Verify installation

After installation, go to Network Map in the app. Your device should appear within 60 seconds with status "Online".

Uninstall

Windows: Control Panel -> Programs -> FlowTux Agent -> Uninstall

Mac/Linux: Run flowtux-agent --uninstall in Terminal

What the agent collects

CPU usage and frequency

Memory usage

Disk usage per volume

Network interface configuration

Running processes (top 10 by CPU)

Installed software list

Pending OS updates

Antivirus status

The agent never reads

Files or documents

Emails or messages

Browser history

Passwords or credentials

Any user-generated content

Install the agent