Installation Guide

Get HyperObserve up and running in 5 minutes with our step-by-step installation guide

Prerequisites

System Requirements

2+ CPU cores (4 recommended)
2GB+ RAM (4GB recommended)
500MB disk space + buffering
Outbound HTTPS (port 443)

Supported Platforms

Linux: Kernel 4.14+ (eBPF support)
Windows: 10/Server 2016+
Kubernetes: 1.19+
Docker: 19.03+

Quick Start (Recommended)

The fastest way to get started. Automatically detects your platform and installs the agent.

Linux/macOS

curl -sSL https://install.hyperobserve.com | sudo bash

Windows (PowerShell)

iex ((New-Object System.Net.WebClient).DownloadString('https://install.hyperobserve.com/win'))

✨ The agent will automatically start with a 7-day trial. No registration required!

Linux Installation

Step 1: Install Prerequisites

# Ubuntu/Debian
sudo apt-get update
sudo apt-get install -y linux-headers-$(uname -r) build-essential

# RHEL/CentOS/Amazon Linux
sudo yum install -y kernel-devel-$(uname -r) gcc make

Step 2: Download and Install

# Download from HyperObserve (registration required)
# Visit: https://www.hyperobserve.com/downloads

# Make executable and install
chmod +x hyperobserve-agent
sudo ./hyperobserve-agent install

# Verify installation
hyperobserve-agent --version

Step 3: Start the Agent

# Start with systemd
sudo systemctl start hyperobserve-agent
sudo systemctl enable hyperobserve-agent

# Check status
sudo systemctl status hyperobserve-agent

✅ Success! The agent is now collecting metrics with eBPF. View your data at app.hyperobserve.com

Windows Installation

Step 1: Download Agent

Download the Windows agent from our downloads page:

Go to Downloads

Step 2: Install as Service

Run PowerShell as Administrator:

# Create directories
New-Item -ItemType Directory -Force -Path "C:\Program Files\HyperObserve"
New-Item -ItemType Directory -Force -Path "C:\ProgramData\HyperObserve\config"
New-Item -ItemType Directory -Force -Path "C:\ProgramData\HyperObserve\logs"

# Copy agent to installation directory
Copy-Item ".\hyperobserve-agent.exe" -Destination "C:\Program Files\HyperObserve\"

# Install service
& "C:\Program Files\HyperObserve\hyperobserve-agent.exe" install

Step 3: Start the Service

# Start service
Start-Service "HyperObserve Agent"

# Verify it's running
Get-Service "HyperObserve Agent"

⚠️ Note: Windows monitoring uses WMI instead of eBPF. Some advanced features are Linux-only.

Kubernetes Installation

Option 1: Quick Deploy

# Deploy HyperObserve DaemonSet
kubectl apply -f https://deploy.hyperobserve.com/kubernetes/daemonset.yaml

Option 2: Helm Chart

# Add HyperObserve Helm repository
helm repo add hyperobserve https://charts.hyperobserve.com
helm repo update

# Install with custom values
helm install hyperobserve hyperobserve/agent \
  --namespace hyperobserve-system \
  --create-namespace \
  --set license.key=YOUR-LICENSE-KEY

Option 3: Manual DaemonSet

View full YAML configuration

apiVersion: apps/v1
kind: DaemonSet
metadata:
  name: hyperobserve-agent
  namespace: hyperobserve-system
spec:
  selector:
    matchLabels:
      app: hyperobserve-agent
  template:
    metadata:
      labels:
        app: hyperobserve-agent
    spec:
      hostNetwork: true
      hostPID: true
      containers:
      - name: agent
        image: hyperobserve/agent:latest
        securityContext:
          privileged: true
        env:
        - name: HYPEROBSERVE_LICENSE_KEY
          valueFrom:
            secretKeyRef:
              name: hyperobserve-license
              key: license-key
        volumeMounts:
        - name: sys
          mountPath: /sys
          readOnly: true
        - name: proc
          mountPath: /host/proc
          readOnly: true
      volumes:
      - name: sys
        hostPath:
          path: /sys
      - name: proc
        hostPath:
          path: /proc

Docker Installation

Run with Docker

# Pull the latest image
docker pull hyperobserve/agent:latest

# Run with required privileges
docker run -d \
  --name hyperobserve-agent \
  --network host \
  --privileged \
  --pid host \
  -v /sys:/sys:ro \
  -v /proc:/proc:ro \
  -v /var/run/docker.sock:/var/run/docker.sock:ro \
  -e HYPEROBSERVE_LICENSE_KEY=your-license-key \
  hyperobserve/agent:latest

Docker Compose

version: '3.8'
services:
  hyperobserve-agent:
    image: hyperobserve/agent:latest
    container_name: hyperobserve-agent
    network_mode: host
    pid: host
    privileged: true
    volumes:
      - /sys:/sys:ro
      - /proc:/proc:ro
      - /var/run/docker.sock:/var/run/docker.sock:ro
    environment:
      - HYPEROBSERVE_LICENSE_KEY=${LICENSE_KEY}
    restart: unless-stopped

Post-Installation Steps

1. Verify Installation

# Check agent version
hyperobserve-agent --version

# Check health status
curl http://localhost:8080/health

# View metrics endpoint
curl http://localhost:8080/metrics

2. Configure Agent (Optional)

The agent works out-of-the-box, but you can customize the configuration:

# Edit configuration
sudo nano /etc/hyperobserve/agent.yaml

# Reload configuration
sudo systemctl reload hyperobserve-agent