Getting Started with Hive

Install the Hive agent and start chatting with your servers in under 2 minutes.

Quick Start

1Add Agent - Create agent in ops0 dashboard

2Install - Run one command on your server

3Chat - Start asking questions

Step 1: Add Your Server

Navigate to Hive in the ops0 dashboard
Click + Add Agent
Name your server (e.g., "production-web-01")
Copy the API key

Important

The API key is shown only once. Copy it before closing the dialog.

Step 2: Install the Agent

Run this command on your server:

curl -fsSL https://your-ops0-domain.com/api/hive/install/script | sudo bash -s -- \
  --url https://your-ops0-domain.com \
  --api-key YOUR_API_KEY

The installer will:

Download the Hive agent binary
Configure it with your API key
Set up systemd service for automatic startup
Start the agent immediately

Verify Installation

# Check if agent is running
sudo systemctl status <agent-service>

# View agent logs
sudo journalctl -u <agent-service> -f

Step 3: Start Chatting

Return to the Hive dashboard
Your server should show ● Online
Click on your server
Click AI Chat
Type your first question: "Is this server healthy?"

AI CHAT - production-web-01

You:Is this server healthy?

Hive: I'll run a comprehensive health check.

✓ CPU: 23% (normal)

✓ Memory: 45% (normal)

✓ Disk: 67% (normal)

✓ Load: 0.45 (healthy)

✓ All critical services running

✓ Server is healthy. No issues detected.

System Requirements

Requirement	Details
OS	Linux (Ubuntu 18.04+, CentOS 7+, Debian 9+), macOS 10.15+
Architecture	x86_64 or ARM64
Memory	64 MB
Network	Outbound HTTPS (no inbound ports needed)

Network Requirements

The agent only makes outbound connections. No firewall changes or inbound ports required. Works through NAT and corporate firewalls.

Installation Options

Standard Installation (Recommended)

curl -fsSL https://your-ops0-domain.com/api/hive/install/script | sudo bash -s -- \
  --url https://your-ops0-domain.com \
  --api-key YOUR_API_KEY

Custom Installation Directory

curl -fsSL https://your-ops0-domain.com/api/hive/install/script | sudo bash -s -- \
  --url https://your-ops0-domain.com \
  --api-key YOUR_API_KEY \
  --install-dir /opt/hive

Manual Installation

If you prefer to install manually:

Download the binary for your platform
Create the agent config file
Set up the service
Start the service

Managing the Agent

Service Commands

# Start agent
sudo systemctl start <agent-service>

# Stop agent
sudo systemctl stop <agent-service>

# Restart agent
sudo systemctl restart <agent-service>

# Check status
sudo systemctl status <agent-service>

# View logs
sudo journalctl -u <agent-service> -f

Uninstall

sudo systemctl stop <agent-service>
sudo systemctl disable <agent-service>
sudo rm /etc/systemd/system/<agent-service>.service
sudo rm -rf <agent-install-dir>
sudo systemctl daemon-reload