GV

GeezerVison

The World Wide Web, restored to 800 pixels of glory.

Home|About|Gaming cabinet|Archives|How it works|Starter sites

On this site

  • docs home page
  • Deployment
  • Inventory
  • Reference
  • Architecture
  • GitHub
  • Community
  • ctrlc sync
  • ctrlc sync pipe
  • ctrlc apply
  • ctrlc api upsert version
  • Glossary & Reference
  • CEL Expression Language
  • RFC 0001: Scoped Versions

This view

  • Original page
  • New address

GeezerVison is showing docs.ctrlplane.dev — CLI Reference - docs

The ctrlc CLI is the primary tool for interacting with Ctrlplane from your terminal, CI/CD pipelines, and automation scripts. It supports syncing resources, managing deployments, and applying configuration.

​
Installation

brew tap ctrlplanedev/tap
brew install ctrlplanedev/tap/ctrlc

npm install -g @ctrlplane/cli

curl -fsSL https://get.ctrlplane.dev | sh

​
Authentication

Set your API key and workspace as environment variables or pass them as flags: 
# Environment variables (recommended)
export CTRLPLANE_API_KEY="your-api-key"
export CTRLPLANE_WORKSPACE="your-workspace-id"
export CTRLPLANE_URL="https://your-ctrlplane-instance.com"

# Or pass as flags
ctrlc --api-key "your-api-key" --workspace "your-workspace-id" <command>

​
Commands

​
ctrlc sync

Sync infrastructure resources into Ctrlplane’s inventory. Each subcommand targets a specific provider or input method.
SubcommandDescription
sync pipeRead resources from stdin (JSON)
sync kubernetesSync Kubernetes cluster resources
sync awsSync AWS resources
sync google-cloudSync Google Cloud resources
sync azureSync Azure resources
sync terraformSync Terraform state resources
sync helmSync Helm releases
sync githubSync GitHub repositories
sync vclusterSync virtual clusters

​
ctrlc api

Interact directly with the Ctrlplane API.
SubcommandDescription
api upsert versionCreate or update a deployment version
See CI/CD Integration for detailed usage.

​
ctrlc apply

Apply resource definitions from YAML files. 
ctrlc apply -f resource.yaml

​
Global Flags

FlagEnvironment VariableDescription
--api-keyCTRLPLANE_API_KEYAPI key for authentication
--workspaceCTRLPLANE_WORKSPACEWorkspace name or ID
--urlCTRLPLANE_URLCtrlplane API URL

​
Next Steps

Sync Pipe

Sync resources from stdin

CI/CD Integration

Use the CLI in CI/CD pipelines

Resource Providers

Built-in resource providers

Custom Provider

Build your own provider

Was this page helpful?

You are visitor 01402503 — GeezerVison does not store the pages you look up.
Best viewed with Netscape Navigator 4.7 or Internet Explorer 6 at 800×600. No cookies required.