Quick Start

Install the LinuxGuard agent and verify enrollment in five minutes on a supported Linux host.

Get LinuxGuard running on your Linux system in 5 minutes.

Prerequisites

Before starting, ensure you have:

• Linux system with kernel 4.18 or later (required for eBPF)

• Root or sudo access

• API Key and Tenant ID from the LinuxGuard console

• Network access to api.linuxguard.io and packages.linuxguard.io

For full system requirements, see the Prerequisites guide.

Step 1: Install

Run the unified installer to download and install the LinuxGuard agent:

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

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

For installation options and troubleshooting, see the Installation Guide.

Step 2: Enroll

Connect the agent to your LinuxGuard tenant:

sudo linuxguard-agent enroll --api-key=<API_KEY> --tenant-id=<TENANT_ID>

Replace:

• <API_KEY> with your API key from the LinuxGuard console

• <TENANT_ID> with your tenant ID

You can find both credentials in the Settings page of the LinuxGuard console.

Expected output:

>> Sending initial snapshot...
>> Initial snapshot sent successfully
>> Successfully enrolled to LinuxGuard Endpoint: https://api.linuxguard.io/v1/

For enrollment options like environments and tags, see the Configuration Guide.

Step 3: Verify

Confirm the agent is running:

sudo linuxguard-agent status

Expected output:

linuxguard-agent is running with PID: 12345

Your server should now appear in the LinuxGuard console within a few moments.

---

Next Step: Console Overview →

Related: Installation Guide | Configuration | What Changed | Agent Commands