Skip to content
FluxPulse Docs

Quick Start

1. Sign Up

Section titled “1. Sign Up”

Create a free workspace at app.fluxpulse.app.

2. Generate Install Token

Section titled “2. Generate Install Token”

In the dashboard, go to Settings → Install Tokens and create a token. Copy it and paste into the install command below. You can view your tokens anytime in the dashboard.

3. Install Agent

Section titled “3. Install Agent”

Paste the install command for your OS:

Linux (Debian/Ubuntu)

Section titled “Linux (Debian/Ubuntu)”
Terminal window
curl -sSL https://app.fluxpulse.app/api/install/linux?token=your_token_here | bash

macOS

Section titled “macOS”
Terminal window
curl -sSL https://app.fluxpulse.app/api/install/macos?token=your_token_here | bash

Windows (PowerShell)

Section titled “Windows (PowerShell)”
Terminal window
$token = "your_token_here"
iex ((New-Object System.Net.WebClient).DownloadString('https://app.fluxpulse.app/api/install/windows?token=' + $token))

4. Watch Metrics Flow

Section titled “4. Watch Metrics Flow”

Return to the dashboard. Within 60 seconds, your host will appear under Servers with live metrics:

  • CPU (overall + per-core)
  • Memory (used, free, buffers, swap)
  • Disk (per-mount usage and I/O)
  • Network throughput
  • Service status (systemd/Windows services)

What’s Next

Section titled “What’s Next”

Troubleshooting

Section titled “Troubleshooting”

Agent not appearing?

  • Verify the install token is correct
  • Check that the host can reach api.fluxpulse.app outbound on port 443
  • See the agent logs: /var/log/fluxpulse-agent.log (Linux) or Event Viewer (Windows)

Metrics incomplete?

  • Metrics are collected every 30 seconds; give it 2–3 minutes for a full picture
  • High-IO operations may temporarily spike CPU/disk readings — this is normal

Still stuck?