Getting Started with Hive

Get up and running with Hive in minutes. Connect your Docker Swarm clusters and start managing your infrastructure from a single dashboard.

Prerequisites

Docker Swarm Cluster

Docker Swarm 19.03+ with at least one manager node

Manager Node Access

SSH access to deploy the Hive agent on manager nodes

Network Connectivity

Manager nodes must be reachable from the Hive server

Optional Integrations

Prometheus

For metrics collection and alerting

Elasticsearch

For centralized log aggregation and search

DNS Provider

Pi-hole for automated DNS management

Installation Steps

Access Hive Dashboard

Register Your Cluster

Click 'Add Cluster' and provide a name, display name, region, environment, and capabilities.

Get the Install Command

Hive generates a bootstrap command with a secure token. Copy this command.

Deploy the Hive Agent

SSH into your Swarm manager node and run the install command. The agent deploys as a global service.

Verify Connection

Return to the dashboard and verify your cluster shows as connected with a green status.

Deploy Your First Service

Navigate to Services and deploy a test service to confirm everything is working.

Optional

Connect AI Agents

Enable AI-powered operations by generating an API key and configuring your MCP-compatible assistant.

Navigate to Settings → API Keys
Click Generate API Key
Configure rate limits and tool allowlists as needed
Add the API key to your MCP client configuration

Works with Claude Code, and any MCP-compatible assistant.

Example MCP Configuration:

{
  "mcpServers": {
    "hive": {
      "url": "https://hive.example.com/mcp",
      "headers": {
        "X-Hive-Api-Key": "your-api-key"
      }
    }
  }
}

Ready to Get Started?

Clone the repository, follow the installation guide, and start managing your Docker Swarm clusters.

View on GitHub Explore Features