Administration Overview

danube-admin is a single binary that provides three interfaces for managing your Danube cluster. All three share the same core functionality.

Management Interfaces

CLI Mode

Command-line interface for scripts, automation, and quick operations.

danube-admin brokers list

CLI Reference →

AI Admin (MCP)

Natural language cluster management through Claude Code, Antigravity, Cursor, or VS Code.

MCP Guide →

HTTP Server

REST API for the Danube Admin UI and custom dashboards.

danube-admin serve --mode http --port 8080

---

Installation

Linux

curl -L -o danube-admin https://github.com/danube-messaging/danube/releases/latest/download/danube-admin-linux
chmod +x danube-admin
sudo mv danube-admin /usr/local/bin/

macOS (Apple Silicon)

curl -L -o danube-admin https://github.com/danube-messaging/danube/releases/latest/download/danube-admin-macos
chmod +x danube-admin
sudo mv danube-admin /usr/local/bin/

Docker

docker pull ghcr.io/danube-messaging/danube-admin:latest

Verify

danube-admin --version

---

Configuration

Environment variables

# Broker admin endpoint (required)
export DANUBE_BROKER_ENDPOINT=http://localhost:50051

# Optional defaults
export DANUBE_NAMESPACE=default
export DANUBE_OUTPUT_FORMAT=json

Command-line flags

# Override endpoint per command
danube-admin --broker-endpoint http://broker1:50051 brokers list

# JSON output for scripting
danube-admin brokers list --output json

---

HTTP Server Mode

The HTTP server mode exposes a REST API that powers the Danube Admin UI.

Start the HTTP server

danube-admin serve --mode http --port 8080 \
  --broker-endpoint http://localhost:50051

Example API usage

# List brokers
curl http://localhost:8080/api/brokers

# Create topic
curl -X POST http://localhost:8080/api/topics \
  -H "Content-Type: application/json" \
  -d '{"name": "/default/events", "partitions": 4}'

# Get cluster balance
curl http://localhost:8080/api/cluster/balance