Skip to content

Home

Jump to bottom
Eric Mann edited this page Sep 23, 2026 · 20 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.

Project status: Displace is no longer under active development, but it remains free to use. As of v3.0.0, there is no account, license key, or paid tier of any kind — every provider, template, and MCP tool is available to everyone.

Current version: v3.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: 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
  • 16 MCP Tools: Every tool is available to every caller — nothing to unlock

Core Commands

The Displace CLI is organized into several main command groups:

  • 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.

Cloud Deployments

Cloud provider access, every template, and all 16 MCP tools are free — there is no account or subscription. See Cloud Providers to get started.

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

  • Monitoring - Prometheus, Grafana, and Alertmanager
  • Configuration - Project and user configuration options
  • Security - Security best practices and hardening

Community and Support

Displace CLI - Infrastructure Management, Simplified

Home

Getting Started

Providers

Templates

Development

Guides

Infrastructure

Reference

Clone this wiki locally