> For the complete documentation index, see [llms.txt](https://docs.linuxguard.io/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.linuxguard.io/install/install.md).

# Install

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](/install/install/container.md) for container-specific instructions.

## What's in this section

* [**Prerequisites**](/install/install/prerequisites.md) — Tenant account, credentials, and system prerequisites required before installing the LinuxGuard agent.
* [**Installation on Debian / Ubuntu**](/install/install/debian-ubuntu.md) — Install the LinuxGuard agent on Debian, Ubuntu, and derivatives via the APT repository.
* [**Installation on RedHat / CentOS**](/install/install/redhat-centos.md) — Install the LinuxGuard agent on RedHat, CentOS, Rocky, and AlmaLinux via the DNF repository.
* [**Installation on SUSE / openSUSE**](/install/install/suse.md) — Install the LinuxGuard agent on SUSE Linux Enterprise and openSUSE via the zypper repository.
* [**Installation on Alpine Linux**](/install/install/alpine.md) — Install the LinuxGuard agent on Alpine Linux via the APK repository.
* [**Container Deployment**](/install/install/container.md) — Container deployment options — when to use Dockerfile, runtime install, Kubernetes, and persistent-volume patterns.

## 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:

```bash
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):**

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

**Non-interactive installation for automation:**

```bash
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](/install/install/debian-ubuntu.md) |
| RedHat Enterprise Linux, CentOS | [Installation on RedHat / CentOS](/install/install/redhat-centos.md) |
| SUSE Linux Enterprise, openSUSE | [Installation on SUSE / openSUSE](/install/install/suse.md)          |
| Alpine Linux                    | [Installation on Alpine Linux](/install/install/alpine.md)           |

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:

```bash
which linuxguard-agent
```

You can also verify that the agent user was created:

```bash
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](/concepts/concepts/security-architecture.md) 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](/operate/operate/uninstallation.md) for instructions.

***

**Next Step**: [Configuration →](/configure/configure.md)

**Related**: [Prerequisites](/install/install/prerequisites.md) | [Debian/Ubuntu Installation](/install/install/debian-ubuntu.md) | [RedHat/CentOS Installation](/install/install/redhat-centos.md) | [SUSE Installation](/install/install/suse.md) | [Alpine Installation](/install/install/alpine.md) | [Automated Deployment](/deploy-at-scale/deploy-at-scale.md)


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter, and the optional `goal` query parameter:

```
GET https://docs.linuxguard.io/install/install.md?ask=<question>&goal=<endgoal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is optional and describes the broader end goal you are ultimately trying to accomplish on behalf of the user. GitBook uses it to tailor the answer towards what is most useful for that goal.

The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.