Debian / Ubuntu

This guide covers repository-based installation on Debian, Ubuntu, and derivatives (such as Linux Mint).

Prerequisites

• Linux kernel 4.18+ (for eBPF support)

• Root or sudo access

• Outbound HTTPS access to packages.linuxguard.io

Note: See Prerequisites for full system requirements.

Repository Setup

The recommended installation method uses the official LinuxGuard APT repository. This ensures you receive automatic updates and can easily manage the agent through your package manager.

Step 1: Install Prerequisites

Install required packages for repository configuration:

sudo apt install curl ca-certificates gnupg

Step 2: Import GPG Key

Create the keyrings directory and import the LinuxGuard signing key:

sudo mkdir -p /etc/apt/keyrings
curl -fsSL https://packages.linuxguard.io/gpg/linuxguard.asc | \
  sudo gpg --dearmor -o /etc/apt/keyrings/linuxguard.gpg

Step 3: Add Repository

Add the LinuxGuard repository to your system:

echo "deb [signed-by=/etc/apt/keyrings/linuxguard.gpg arch=$(dpkg --print-architecture)] \
  https://packages.linuxguard.io/apt stable main" | \
  sudo tee /etc/apt/sources.list.d/linuxguard.list

Step 4: Install Agent

Update the package index and install the agent:

sudo apt update
sudo apt install linuxguard-agent

The agent service will be installed but not started until enrollment.

Direct Download

If repository setup is not possible, you can download and install the package directly:

curl -fsSL -o linuxguard-agent.deb \
  https://packages.linuxguard.io/apt/pool/linuxguard-agent_latest_$(dpkg --print-architecture).deb
sudo dpkg -i linuxguard-agent.deb

Verification

After installation, verify the agent is correctly installed:

Check Agent Binary

Confirm the agent binary is in your PATH:

which linuxguard-agent

Expected output:

/usr/bin/linuxguard-agent

Verify Agent User

Confirm the agent user and group were created:

id linuxguard

Expected output:

uid=999(linuxguard) gid=999(linuxguard) groups=999(linuxguard)

Note: The UID/GID numbers may vary depending on your system.

Check Service Status

Verify the agent service is installed:

sudo systemctl status linuxguard-agent

Expected output:

○ linuxguard-agent.service - LinuxGuard Security Agent
     Loaded: loaded (/lib/systemd/system/linuxguard-agent.service; disabled; preset: enabled)
     Active: inactive (dead)

The service is inactive until you complete enrollment.

Troubleshooting

Repository Not Found

If apt update fails to find the LinuxGuard repository, verify the repository file exists:

cat /etc/apt/sources.list.d/linuxguard.list

The file should contain the repository configuration with the correct architecture.

GPG Key Errors

If you encounter GPG signature verification errors, verify the key was imported correctly:

ls -l /etc/apt/keyrings/linuxguard.gpg

If the file is missing, repeat Step 2 of the repository setup.

Package Conflicts

If installation fails due to conflicting packages, check for unofficial or third-party LinuxGuard packages:

apt list --installed | grep linuxguard

Remove any unofficial packages before installing from the official repository.

Note: See the Troubleshooting Guide for additional help.

---

Next Step: Configuration →

Related: Installation Overview | Prerequisites | Troubleshooting