Installing the Redamp.io application on Linux devices

Learn how to install the Redamp.io application on all your Linux devices.

Installing the Redamp.io application on Linux devices

Learn how to install the Redamp.io application on your Linux
devices.

Early access: The Linux agent is currently available on demand. To get access, contact us at [email protected] and we will provide you with the download link and any additional onboarding steps.

The Linux agent runs as a system daemon (systemd) and is controlled through the redampio CLI. All daemon-facing commands must be run as root (sudo) because the agent's local control socket is restricted to root.

1. Install

You will receive a direct download URL from Redamp.io. Only amd64 (x86_64) is supported at this time.

Debian / Ubuntu (.deb, primary supported platform):

$ curl -L -o redampio.deb "https://download-url/redampio.deb "

$ sudo apt install ./redampio.deb

Fedora / AlmaLinux (.rpm, tested but not officially supported):

$ curl -L -o redampio.rpm "https://download-url/redampio.rpm "

$ sudo dnf install ./redampio.rpm

The package installs the redampio binary, creates the redampio service user, and enables the daemon. Run the built-in diagnostics to confirm everything came up cleanly:

$ sudo redampio doctor

You should see all checks pass.

Verifying the package signature (optional)

Both the .deb and .rpm artifacts are signed with a shared Redamp.io GPG key. The public key is published at https://linux.redamp.io/redampio-signing.pub.asc, so if your environment requires it, you can verify the package authenticity before installing — using the standard verification tools shipped with your distribution.

2. Log in

Authenticate the agent against the Redamp.io backend. The backend returns an API key which is stored encrypted on disk; the password itself is never persisted.

Pick whichever flow fits your environment — both end up in the same authenticated state.

$ sudo redampio login --email [email protected]

You will be prompted for the password (input is masked). If a password manager already holds the secret, you can pipe it in non-interactively:

$ sudo redampio login --email [email protected] --password "$(secret-tool lookup …)"

This is the right flow for SSH sessions, configuration management (Ansible, Salt, …), or any unattended automation.

2b. Interactive dashboard (guided UI)

Run the full-screen terminal dashboard and log in from there:

$ sudo redampio interactive

Use arrow keys (or j/k) to navigate, Enter to select, Esc to go back, q to quit. The dashboard exposes the same login flow with a masked password field plus live panels for service status, scan results, and update prompts.

opens its WebSocket connection to the backend,
triggers an initial device + network scan shortly afterwards,
starts receiving push commands (background scans, log requests, auto-update notifications).

You can verify the state at any time:

$ sudo redampio status

The output shows the daemon version, the WebSocket connection state, the authenticated user / organization, and the timestamp of the last successful scan.

After a short while the device will appear in the Redamp.io web
console with its first scan results.

If you ever need to trigger a scan manually, run:
$ sudo redampio scan fullscan

Working with the Redamp.io application

List all available commands:

$ sudo redampio help

Open the full-screen interactive dashboard (live status, manual scan triggers, update prompt, login, logout):

$ sudo redampio interactive

All scan results are visible in the Redamp.io web console.

Available commands

Command	Purpose
`$` `sudo redampio login`	Authenticate with email + password (password is prompted if not passed).
`$` `sudo redampio register`	Register the agent with a provisioning token (unattended rollouts).
`$` `sudo redampio logout`	Sign the agent out of the backend (asks for confirmation; use `-y` to skip).
`$` `sudo redampio status`	Show daemon state: WebSocket, account, last scan, version.
`$` `sudo redampio scan device`	Run an on-demand device inventory scan.
`$` `sudo redampio scan network`	Run an on-demand network scan (Wi-Fi / Ethernet).
`$` `sudo redampio scan fullscan`	Run device + network scan back-to-back in one daemon request.
`$` `sudo redampio update`	Check for a newer agent version and apply it immediately (downloads, verifies, swaps).
`$` `sudo redampio doctor`	Diagnose a broken install (socket, daemon reachability, systemd unit, machine-id).
`$` `sudo redampio interactive`	Open the interactive terminal UI (alias: `ui`).
`$` `redampio version`	Print the installed agent version (no root required).

Installing the Redamp.io application on Linux devices