# vpctl command reference

> Reference documentation for vpctl commands, flags, workflows, and deployment operations

Use this page to find command references for vpctl. To get started with vpctl and learn about recommended deployment workflows, refer to [vpctl](/cloud/virtual-private-cloud/vpctl.md) and [Architecture and security](/cloud/virtual-private-cloud/vpctl/architecture.md).

[Release](/cloud/virtual-private-cloud/vpctl/commands/release.md): pull, generate, deploy, uninstall
[Artifact](/cloud/virtual-private-cloud/vpctl/commands/artifact.md): sync preflight, sync images, sync oras, sync charts
[Secret](/cloud/virtual-private-cloud/vpctl/commands/secret.md): generate, deploy
[Manifest](/cloud/virtual-private-cloud/vpctl/commands/manifest.md): init, validate, schema
[Configure](/cloud/virtual-private-cloud/vpctl/commands/configure.md): Set, view, and delete registry credentials


## Global flags

You can use these flags with any command:

* `--manifest <path>`: Path to manifest.yaml file (default: auto-discover)
* `--log-level <level>`: Set logging level (`trace`, `debug`, `info`, `warn`, `error`, `fatal`, `panic`; default: `info`)
* `--json`: Output logs in JSON format

Example:

```sh
vpctl release pull --version 1.2.3 --log-level debug
```

## Command summary

| Command                             | Description                                                                                                          |
| ----------------------------------- | -------------------------------------------------------------------------------------------------------------------- |
| `vpctl version`                     | Print the version number                                                                                             |
| `vpctl configure`                   | Set registry credentials (interactive)                                                                               |
| `vpctl configure get`               | View configuration                                                                                                   |
| `vpctl configure set [registry]`    | Set registry credentials (non-interactive)                                                                           |
| `vpctl configure delete [registry]` | Delete registry credentials                                                                                          |
| `vpctl manifest init`               | Initialize a new manifest file interactively                                                                         |
| `vpctl manifest validate`           | Validate a manifest file against the CUE schema                                                                      |
| `vpctl manifest schema`             | Display the CUE schema (or export it for standalone validation)                                                      |
| `vpctl release pull`                | Pull a release from the registry                                                                                     |
| `vpctl release generate`            | Generate release configuration (Helm/ArgoCD charts)                                                                  |
| `vpctl release deploy`              | Deploy a release (Helm or ArgoCD)                                                                                    |
| `vpctl release uninstall`           | Uninstall a release                                                                                                  |
| `vpctl artifact sync preflight`     | Verify registry authentication by syncing one image, one ORAS artifact, and (in remote chart mode) one Helm chart    |
| `vpctl artifact sync images`        | Sync Docker images from the source registry to the target registry                                                   |
| `vpctl artifact sync oras`          | Sync ORAS artifacts from the source registry to the target registry                                                  |
| `vpctl artifact sync charts`        | Sync OCI Helm charts from the source registry to the target registry (requires `deployment.helmChartMode: "remote"`) |
| `vpctl secret generate`             | Generate Kubernetes secret YAML from schema definitions                                                              |
| `vpctl secret deploy`               | Deploy secrets to your Kubernetes cluster                                                                            |
