qovery demo

Try Qovery on your local machine

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

Flag	Description
--cluster-name / -c	The name of the cluster to create (default: local-demo-<username>)
--debug	Enable debug mode

demo destroy

Destroy the local demo cluster:

qovery demo destroy

Flag	Description
--cluster-name / -c	The name of the cluster to destroy (default: local-demo-<username>)
--delete-qovery-config / -d	Delete 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

Related Commands

• qovery auth - Authenticate with Qovery
• qovery context - Set working context
• qovery application deploy - Deploy applications