> ## Documentation Index
> Fetch the complete documentation index at: https://www.qovery.com/docs/llms.txt
> Use this file to discover all available pages before exploring further.

# 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:

```bash theme={null}
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:

```bash theme={null}
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

```bash theme={null}
# 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

```bash theme={null}
# 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

<Tip>
  The demo runs entirely on your local machine. It's safe to experiment without affecting any cloud resources.
</Tip>

<Tip>
  Use the demo to learn Qovery CLI commands before working with production environments.
</Tip>

<Warning>
  Ensure Docker Desktop has sufficient resources allocated (at least 4GB RAM, 2 CPUs).
</Warning>

## Next Steps

After trying the demo:

1. [Set up Qovery](/quickstart) on your infrastructure
2. [Deploy your first app](/guides/getting-started/deploy-your-first-application)
3. Explore [advanced features](/guides/use-cases/production-environment-management)

## Related Commands

* [`qovery auth`](/cli/commands/auth) - Authenticate with Qovery
* [`qovery context`](/cli/commands/context) - Set working context
* [`qovery application deploy`](/cli/commands/application) - Deploy applications