Installation

This guide covers installing the LinuxGuard agent on your Linux systems. You can choose between two installation approaches: a unified installer script that automatically detects your distribution (recommended for quick setup), or distribution-specific repository configuration (recommended for production environments).

Note: Installing in a container? See the Container Installation Guide for container-specific instructions.

System Requirements

Before installing, ensure your system meets these requirements:

• Kernel: Linux kernel 4.18 or later (required for eBPF runtime detection)

• Architecture: x86_64 (AMD64) or aarch64 (ARM64)

• Network: Outbound HTTPS access to api.linuxguard.io and packages.linuxguard.io

• Permissions: Root or sudo access for installation

Option A: Unified Installer (Recommended for Quick Setup)

The unified installer automatically detects your Linux distribution and configures the appropriate package repository:

curl -fsSL https://packages.linuxguard.io/install-linuxguard.sh | sudo bash

The installer will:

• Detect your Linux distribution (Debian/Ubuntu, RedHat/CentOS, openSUSE/SLES, or Alpine)

• Configure the appropriate package repository (APT, DNF/YUM, Zypper, or APK)

• Install the LinuxGuard agent package and the sysstat dependency (provides iostat/mpstat for system metrics collection)

Installer Options

The installer supports the following options:

Option	Description
--yes or -y	Non-interactive mode for automated deployments (CI/CD, configuration management).
--fix-repo	Repair existing repository configuration. Use if repository configuration becomes corrupted.
--help or -h	Display help message.

Installation Examples

Basic installation (interactive):

curl -fsSL https://packages.linuxguard.io/install-linuxguard.sh | sudo bash

Non-interactive installation for automation:

curl -fsSL https://packages.linuxguard.io/install-linuxguard.sh | sudo bash -s -- --yes

Option B: Distribution-Specific Installation

For production environments where you want explicit control over repository configuration, follow the guide for your distribution:

Distribution	Guide
Debian, Ubuntu, Linux Mint	Installation on Debian / Ubuntu
RedHat Enterprise Linux, CentOS	Installation on RedHat / CentOS
SUSE Linux Enterprise, openSUSE	Installation on SUSE / openSUSE
Alpine Linux	Installation on Alpine Linux

Each guide provides step-by-step instructions for:

• Manual repository configuration with GPG key verification

• Distribution-specific package manager commands

• Direct package download as an alternative

• Distribution-specific troubleshooting tips

Verification

After installation, the LinuxGuard agent service should be installed but not yet running (it needs to be configured first). You can verify the installation by checking if the agent binary exists:

which linuxguard-agent

You can also verify that the agent user was created:

id linuxguard

Security

The LinuxGuard agent is installed with security as a top priority. The installer creates a dedicated linuxguard user account, and the agent runs without root privileges with read-only access to system components. For detailed information about our security architecture, see the Security Architecture page.

Uninstallation

If you need to remove the LinuxGuard agent, we provide a complete cleanup process that removes all agent files, configuration, and user accounts. See the Uninstallation Guide for instructions.

---

Next Step: Configuration →

Related: Prerequisites | Debian/Ubuntu Installation | RedHat/CentOS Installation | SUSE Installation | Alpine Installation | Automated Deployment