Skip to content
Eric Mann edited this page Mar 19, 2026 · 19 revisions

Displace CLI Documentation

Welcome to the Displace CLI — a powerful infrastructure management tool that simplifies Kubernetes deployments across any cloud provider or bare metal environment.

Current version: v2.0.0 — Dual-interface architecture (CLI + MCP server), build-from-source templates, official upstream container images.

What is Displace?

Displace is a single Go binary that provides two interfaces to the same core engine:

  • displace cli [command] — Human-facing CLI powered by Cobra
  • displace mcp serve — AI-facing MCP server (JSON-RPC 2.0 over stdio)

Whether you're deploying to AWS, GCP, DigitalOcean, or running locally with k3d, Displace provides a unified experience with powerful features for modern infrastructure.

Key Features

  • Dual Interface: Use the CLI directly or connect your AI assistant via the MCP server
  • Multi-Cloud Support: Deploy to AWS, GCP, DigitalOcean, or local k3d clusters with the same commands
  • Local Development: Free local Kubernetes clusters for development and testing
  • Build-from-Source Templates: WordPress template builds from official sources — no third-party images
  • Robust Monitoring: Built-in Prometheus, Grafana, and Alertmanager for complete observability
  • Security First: Cloudflare Tunnel integration, secrets management, and security best practices
  • SRE Operations: Rolling restarts, rollbacks, metrics, alerts, and runbooks built-in
  • Tiered MCP Tools: 18 tools across 4 license tiers, from free Community to Founder

Core Commands

The Displace CLI is organized into several main command groups:

  • displace auth - Authentication and API key management
  • displace provider - Cloud provider configuration and management
  • displace cluster - Kubernetes cluster lifecycle management
  • displace project - Application project deployment and management
  • displace registry - Container registry management
  • displace mcp - MCP server for AI agent interaction
  • displace config - CLI configuration management

Quick Example

# Configure AWS provider
$ displace provider aws configure

# Create a Kubernetes cluster
$ displace cluster create production --provider aws

# Create your application from a template (i.e. WordPress)
$ displace project init wordpress

# Deploy your application
$ displace project deploy --cluster production

# Check cluster status
$ displace cluster status production --provider aws

Getting Started

New to Displace? Follow our comprehensive Getting Started Guide - a complete tutorial that takes you from zero to a running WordPress site in about 15 minutes.

Free Local Development

Local development with Displace is always free. You can:

  • Set up local Kubernetes clusters with k3d
  • Deploy applications locally
  • Test your configurations
  • Learn the Displace workflow

For quick reference, see the Quick Start Guide.

Paid Plans for Cloud Deployments

For cloud provider access and advanced MCP tools, visit displace.tech to explore subscription tiers:

  • Community (Free) — Local clusters, all templates, 6 MCP tools
  • Starter ($29/mo per cluster) — One cloud provider, 12 MCP tools
  • Professional ($79/mo per cluster) — All providers, compliance tools, 16 MCP tools
  • Founder ($499/mo flat) — Unlimited clusters, HIPAA/FedRAMP compliance, 18 MCP tools

Documentation Structure

Getting Started

Providers

Application Templates

Development Tools

Guides

Infrastructure & Security

Reference

  • Changelog - Version history and release notes
  • Roadmap - Planned features and CLI development

Advanced Topics

Community and Support


Displace CLI - Infrastructure Management, Simplified

Clone this wiki locally