Install Agents

Installing a FluxPulse agent takes less than a minute. The agent collects system metrics every 30 seconds and sends them to your dashboard.

Step 1: Generate Install Token

In the FluxPulse dashboard, go to Settings → Install Tokens and click Create New Token.

Give it a name (e.g., “Production Servers”) and copy the token. You’ll use it once.

Step 2: Pick Your OS

Linux / macOS

curl -sSL https://app.fluxpulse.app/api/install/linux?token=your_token_here | bash

For macOS specifically:

curl -sSL https://app.fluxpulse.app/api/install/macos?token=your_token_here | bash

The script:

• Downloads the agent binary for your CPU (Intel or ARM)
• Creates a systemd service (Linux) or launchd daemon (macOS)
• Registers with FluxPulse
• Starts collecting metrics

Windows (PowerShell as Administrator)

$token = "your_token_here"
$url = "https://app.fluxpulse.app/api/install/windows?token=$token"
iex ((New-Object System.Net.WebClient).DownloadString($url))

The installer:

• Downloads the Windows agent
• Installs as a Windows Service
• Registers with FluxPulse
• Starts collecting metrics

Step 3: Verify It’s Working

Go back to the dashboard. Your server should appear under Servers within 60 seconds.

You’ll see:

• Hostname — Your server name
• Status — Online (green) or Offline (gray)
• CPU, Memory, Disk — Real-time metrics
• Services — Status of running systemd/Windows services

Troubleshooting

Agent doesn’t appear after 2 minutes?

Check:

1. You copied the token correctly (no extra spaces)
2. The server has internet access on port 443 (HTTPS)
3. Installation completed without errors

For help, copy the error message and email hello@fluxpulse.app.

Monitoring Multiple Servers

Repeat the steps for each server. You can:

• Use the same install token for all servers
• Or create a new token for each server (optional, for organization)

Bulk Installation

For teams managing many servers, you can automate with:

Ansible:

- name: Install FluxPulse agent
  shell: |
    curl -sSL https://app.fluxpulse.app/api/install/linux?token={{ token }} | bash

Terraform / Cloud-Init:

#!/bin/bash
curl -sSL https://app.fluxpulse.app/api/install/linux?token=your_token_here | bash

System Requirements

• Linux: Debian 11+, Ubuntu 20.04+, RHEL 8+, Alpine (x86_64 or ARM)
• macOS: 10.12+ (Intel or Apple Silicon)
• Windows: Server 2019/2022 or Windows 10/11 (x86_64)
• Disk: 5–10 MB
• RAM: <10 MB (negligible impact)

Uninstall

Linux:

sudo systemctl stop fluxpulse-agent
sudo systemctl disable fluxpulse-agent
sudo rm /usr/local/bin/fluxpulse-agent /etc/systemd/system/fluxpulse-agent.service

macOS:

launchctl unload ~/Library/LaunchAgents/com.fluxpulse.agent.plist
rm ~/Library/LaunchAgents/com.fluxpulse.agent.plist /usr/local/bin/fluxpulse-agent

Windows:

Stop-Service FluxPulseAgent
Remove-Service FluxPulseAgent
Remove-Item "C:\Program Files\FluxPulse" -Recurse

---

Next: Head to the dashboard and start monitoring your infrastructure!