Back to Home
Ghost Logo

Ghost CLI

Manage your Ghost Networks from the command line. Automate device provisioning, network management, and infrastructure operations via CLI or API.

Install with one command (macOS / Linux):

curl -fsSL https://gh-o.net/d/cli/install.sh | bash

Or via Homebrew:

brew install habloapp/ghost/ghost-cli

Auto-detects your OS and architecture.

Download v0.30.0

macOS

macOS

Universal (Intel + Apple Silicon)
Linux

Linux x64

AMD64 / x86_64
Linux ARM

Linux ARM64

Raspberry Pi / AWS Graviton

Quick Start

macOS / Linux

# Install via Homebrew
brew install habloapp/ghost/ghost-cli

# Or install via script (auto-detects OS and architecture)
curl -fsSL https://gh-o.net/d/cli/install.sh | bash

# Initialize with your API key
ghost-cli init YOUR_API_KEY

# List your networks
ghost-cli network list

REST API Server

# Start the server (bound to WireGuard IP, hub-restricted)
ghost-cli server --hub my-hub --port 8080

# From any device in the hub:
curl http://10.0.0.5:8080/v1/networks
curl http://10.0.0.5:8080/v1/hubs

# Install as system service (auto-restarts)
ghost-cli server install --hub my-hub --port 8080

What You Can Do

Network Management

Create, list, and manage networks. Add or remove devices programmatically. Control Phantom Hubs and roles.

Helbind Keys

Generate and revoke Helbind Keys for automated device provisioning. Perfect for CI/CD pipelines and fleet management.

BiFrost Pass

Create and manage BiFrost Passes for temporary server access. Automate event-based access provisioning.

Automation & Scripting

Integrate with your existing tools. Use API keys for headless operation. JSON output for easy parsing.

REST API Server

Built-in HTTP server bound to your WireGuard interface. Hub-based access control ensures only authorized devices can call the API. Automatic license validation, systemd/launchd support, and agent-monitored auto-restart.

View Pricing | Back to Home