Skip to main content

scani5 Agent Installation (Linux)

Step-by-step guide to install, configure, and verify the scani5 Linux Agent on Debian/Ubuntu (.deb) and RHEL/CentOS (.rpm) endpoints. The agent runs as a background system service, providing continuous endpoint visibility, software and patch inventory, identity exposure monitoring, and security configuration assessment.

Table of Contents​

  1. Deployment Overview
  2. Debian & Ubuntu Installation (.deb)
  3. RHEL, CentOS, Rocky Linux & Fedora Installation (.rpm)
  4. Verify Installation
  5. Service Operations & Complete Purge

1. Deployment Overview​

The scani5 Agent can be deployed using either of the following methods:

MethodDescription
Option 1: Manual / Interactive Package Installation (covered in this guide)Direct terminal installation using native package managers (dpkg for Ubuntu/Debian or rpm for RHEL/CentOS) on individual endpoints.
Option 2: Enterprise Automated Fleet RolloutSilent, non-interactive deployment across server clusters using Ansible, Puppet, Chef, Terraform, or Bash automation scripts with pre-seeded organization keys.
Operating SystemPackage Type
Ubuntu, Debian.deb (e.g. Scani5_1.0.0.deb)
RHEL, CentOS, Rocky Linux, AlmaLinux, Fedora.rpm (e.g. Scani5_1.0.0.rpm)
Before You Start

Ensure the target machine has outbound HTTPS access (TCP 443) and administrative (sudo) credentials available.

2. Debian & Ubuntu Installation (.deb)​

Step 1: Locate the downloaded package​

Navigate to the directory where the installer package was saved (for example, the Downloads folder) and confirm that Scani5_1.0.0.deb is present.

Step 1 - Locate the .deb package

Step 2: Open a terminal and navigate to the package​

cd ~/Downloads
ls

Step 3: Run the installer​

sudo dpkg -i Scani5_1.0.0.deb

Step 4: Enter organization hash​

The installer unpacks the binaries, configures file permissions, and presents the scani5 Agent Configuration prompt. Paste your Organization Hash and press Enter.

=================================================================
Scani5 Agent Configuration
=================================================================
Please enter your Scani5 Organization Hash:

Step 4 - Organization hash prompt (.deb)

Automated Security Setup

The installer writes the Organization Hash to /root/Scani5/Scani5Agent/Scani5Org.txt with restricted 0600 permissions, reloads systemd, enables the service to start on boot, and immediately launches the agent.

3. RHEL, CentOS, Rocky Linux & Fedora Installation (.rpm)​

On RHEL, CentOS, Rocky Linux, AlmaLinux, and Fedora systems, the agent is distributed as an RPM package.

Step 1: Locate the RPM package​

Confirm that Scani5_1.0.0.rpm has been transferred to the target machine (for example, to the Desktop or /tmp).

Step 1 - Locate the .rpm package

Step 2: Run the installer​

Open a terminal, navigate to the folder containing the package, and run:

cd ~/Desktop
sudo rpm -ivh Scani5_1.0.0.rpm

Step 3: Enter organization hash​

The installer verifies the package, prepares the file layout, and displays the configuration prompt. Paste your Organization Hash and press Enter.

Step 3 - Organization hash prompt (.rpm)

4. Verify Installation​

Headless Background Execution

The scani5 Linux Agent runs silently in the background as a headless systemd daemon under the root account. Use the checks below to confirm the agent is healthy.

Check service status​

sudo systemctl status scani5agent

Ubuntu / Debian:

Service status on Ubuntu

RHEL / CentOS:

Service status on RHEL

Confirm the output matches the expected values below:

AttributeExpected StateDescription
Service Namescani5agent.servicesystemd unit registered under /etc/systemd/system/.
Loadedloaded (...; enabled)Service starts automatically on every reboot.
Activeactive (running)Daemon is actively running background security watchers.
Main PIDInteger (e.g. 4854)Process ID of /opt/scani5/Scani5Agent.
Memory50 MB – 160 MBHealthy resident memory footprint.

Check the agent log​

Verify that registration, secret negotiation, and the initial inventory push succeeded:

sudo tail -n 20 /root/Scani5/Logs/Scani5_Log.txt

Expected output:

App Version: 1.0.0
First run detected. Initiating registration.
Agent registered and secret saved.
Collecting Software inventory.
Initial inventory successfully sent.
Initial User Profile details successfully sent.
Configuration assessment completed.

Check the running process​

ps aux | grep -i Scani5Agent | grep -v grep

Expected output:

root  5989  0.2  1.8 160520 51200 ?  Ssl  01:37  0:06 /opt/scani5/Scani5Agent

5. Service Operations & Complete Purge​

OperationCommand
Check service statussudo systemctl status scani5agent.service
Restart the agentsudo systemctl restart scani5agent.service
Stop the agentsudo systemctl stop scani5agent.service
Stream live logssudo journalctl -u scani5agent.service -f
Complete purge (Ubuntu / Debian)sudo apt purge -y scani5 (stops service & deletes all DB/cache)
Complete purge (RHEL / CentOS)sudo rpm -e scani5 (stops service & deletes all DB/cache)