Install the spane agent
The agent enrolls into your spane server with a one-time token, gets a unique mTLS client certificate, and pushes metrics outbound — no inbound ports. Generate a token in Settings → Agents, then run the command for your platform.
curl -fsSL https://YOUR_SPANE/agent/install | sudo bash -s -- \
--server https://YOUR_SPANE \
--token YOUR_ENROLLMENT_TOKEN Self-signed server certificate
curl -fsSL -k https://YOUR_SPANE/agent/install | sudo bash -s -- \
--server https://YOUR_SPANE \
--token YOUR_ENROLLMENT_TOKEN \
--insecure Manual install (download binary + enroll)
# match your server arch: linux-amd64 or linux-arm64
sudo curl -fsSL https://YOUR_SPANE/agent/download/linux-amd64 \
-o /usr/local/bin/netpulse-agent
sudo chmod +x /usr/local/bin/netpulse-agent
sudo netpulse-agent --enroll YOUR_TOKEN --server https://YOUR_SPANE \
--config /etc/netpulse-agent/config.json
sudo systemctl enable --now netpulse-agent - Installs and starts a low-privilege
netpulse-agentsystemd unit. - Re-running is safe — it re-enrolls in place and rotates the certificate.
- Verify:
systemctl status netpulse-agentand check Servers → All Servers.
# download the binary, then enroll + install the service
Invoke-WebRequest -Uri "https://YOUR_SPANE/agent/download/windows-amd64" `
-OutFile "$env:ProgramFiles\spane\netpulse-agent.exe"
& "$env:ProgramFiles\spane\netpulse-agent.exe" --enroll YOUR_TOKEN `
--server "https://YOUR_SPANE" --config "$env:ProgramData\spane\config.json"
& "$env:ProgramFiles\spane\netpulse-agent.exe" --install-service
The /agent/install.ps1 one-liner endpoint is not wired up
yet — install Windows agents manually with the commands above. Add
-Insecure for a self-signed server certificate.
- Requires an elevated (Administrator) PowerShell session.
- Runs as a Windows Service; collects CPU / memory / disk / network and role health.
The installer pulls the matching binary straight from your spane server, so it always matches your deployment. For air-gapped installs or to pin a specific version, download signed binaries and checksums from GitHub releases.
View releases on GitHubVerifying signed binaries? See Security → code signing.