Skip to main content

Install Argus Sensors

You’ll enroll a Sensor on a Linux host. After it appears online, Argus can run uptime checks and stress tests from that region.

Before you start​

  • An organization selected in the dashboard
  • Permission to use Argus in that organization (owners and Full access members have it)
  • A Linux host (amd64 or arm64) with outbound HTTPS to the Xooshe API
  • sudo on that host

You do not enter an IP or hostname in the dashboard — the install command enrolls the Sensor automatically.

Add a Sensor​

  1. Open Argus → Sensors.
  2. Click Add Sensor.
  3. Optionally set Sensor name (for example FRA-01), Region, and Zone.
  4. Click Generate install command.
  5. Copy the Installation command.
  6. On the Linux host, run the command with sudo (paste as shown).
  7. Leave the dialog open until the Sensor appears (Waiting for sensor… → discovered).

The enrollment token is one-time and expires. After you close the dialog you cannot show the same command again — generate a new one if needed.

Manage Sensors​

On Sensors you can see status, last seen, platform, architecture, assigned checks, and binary sync.

Use Revoke sensor when a host is retired or compromised. Revoked Sensors stop receiving checks.

You’re done when​

If it fails​

SymptomFix
Token expired or install rejectedGenerate a new install command and run it again
Sensor never appearsConfirm outbound HTTPS from the host to the Xooshe API; re-check the pasted command
Unsupported platformUse Linux on amd64 or arm64 only
No permission / empty ArgusSelect the right organization; ask an owner for Argus access