Skip to main content

Overview

Try Qovery on your local machine with a demo environment. The demo command has two subcommands: up to create a local cluster and install Qovery, and destroy to tear it all down.

Commands

demo up

Set up a local Kubernetes cluster and install Qovery:
qovery demo up
FlagDescription
--cluster-name / -cThe name of the cluster to create (default: local-demo-<username>)
--debugEnable debug mode

demo destroy

Destroy the local demo cluster:
qovery demo destroy
FlagDescription
--cluster-name / -cThe name of the cluster to destroy (default: local-demo-<username>)
--delete-qovery-config / -dDelete the config on Qovery side as well (environments and associated cluster)

Prerequisites

Before running the demo:
  • Docker - Docker Desktop must be installed and running
  • Kubectl - Kubernetes CLI should be available
  • Sufficient Resources - At least 4GB RAM available for Docker

Examples

Start the Demo

# Start with default cluster name
qovery demo up

# Start with a custom cluster name
qovery demo up --cluster-name "my-demo"

# Start with debug output enabled
qovery demo up --debug

Destroy the Demo

# Destroy the local cluster
qovery demo destroy

# Destroy the local cluster and remove Qovery-side config
qovery demo destroy --delete-qovery-config

# Destroy a specific named cluster
qovery demo destroy --cluster-name "my-demo"

Tips

The demo runs entirely on your local machine. It’s safe to experiment without affecting any cloud resources.
Use the demo to learn Qovery CLI commands before working with production environments.
Ensure Docker Desktop has sufficient resources allocated (at least 4GB RAM, 2 CPUs).

Next Steps

After trying the demo:
  1. Set up Qovery on your infrastructure
  2. Deploy your first app
  3. Explore advanced features