Installation

KairOS Red endpoint agent is available for Linux, macOS, and Windows. Choose your platform below for detailed installation instructions.

System Requirements

PlatformArchitectureMinimum Version
Linuxx86_64, aarch64Kernel 5.10+
macOSx86_64, arm6413.0+ (Ventura)
Windowsx86_6410 22H2+ / 11

Linux Installation

Debian / Ubuntu (apt)

# Add the KairOS Red APT repository curl -fsSL https://apt.kairosnetwork.red/gpg.key | sudo gpg --dearmor -o /usr/share/keyrings/kairos.gpg echo "deb [signed-by=/usr/share/keyrings/kairos.gpg] https://apt.kairosnetwork.red stable main" | sudo tee /etc/apt/sources.list.d/kairos.list # Update and install sudo apt update sudo apt install kairos-endpoint # Verify installation kairos --version

Fedora / RHEL / Rocky Linux (rpm)

# Add the KairOS Red RPM repository sudo dnf config-manager --add-repo https://rpm.kairosnetwork.red/kairos.repo # Install the endpoint sudo dnf install kairos-endpoint # Verify installation kairos --version

openSUSE (zypper)

# Add the KairOS Red repository sudo zypper addrepo https://rpm.kairosnetwork.red/kairos.repo # Install sudo zypper install kairos-endpoint

Generic Linux (static binary)

# Download the latest release curl -fsSL https://releases.kairosnetwork.red/latest/kairos-endpoint-linux-amd64.tar.gz -o /tmp/kairos.tar.gz # Extract and install sudo tar -xzf /tmp/kairos.tar.gz -C /usr/local/bin/ sudo chmod +x /usr/local/bin/kairos # Verify kairos --version

macOS Installation

Homebrew (recommended)

# Tap the KairOS Red Homebrew repository brew tap kairos-red/homebrew-tap # Install the endpoint brew install kairos-endpoint # Verify installation kairos --version

Manual .pkg Installer

# Download the package curl -fsSL https://pkg.kairosnetwork.red/kairos-endpoint.pkg -o /tmp/kairos-endpoint.pkg # Install sudo installer -pkg /tmp/kairos-endpoint.pkg -target / # Verify kairos --version

Windows Installation

MSI Installer (Graphical)

  1. Download the MSI installer from kairos-endpoint-latest.msi
  2. Double-click the MSI file to start the installer
  3. Follow the installation wizard
  4. Launch KairOS Red from the Start Menu

Silent Installation (Command Line)

# Download the MSI curl -fsSL https://msi.kairosnetwork.red/kairos-endpoint-latest.msi -o kairos-endpoint.msi # Install silently msiexec /i kairos-endpoint.msi /quiet /norestart

Chocolatey

choco install kairos-endpoint

winget

winget install KairOS.Endpoint

Post-Installation Verification

After installation, verify the endpoint agent is working:

# Check the daemon status kairos status # View the version and build info kairos --version # Check system requirements kairos doctor

Uninstalling

Linux (apt)

sudo apt remove kairos-endpoint

Linux (rpm)

sudo dnf remove kairos-endpoint

macOS (Homebrew)

brew uninstall kairos-endpoint

Windows

msiexec /x kairos-endpoint.msi /quiet

Next Steps