qovery-cli

Qovery helps tech companies to accelerate and scale application development cycle with zero infrastructure management investment.

This repository is the code source of the Qovery CLI.

See the Qovery documentation to get started with Qovery.

See the Qovery CLI documentation to get started with the CLI and explore its commands.

Installation

Choose the installation method for your platform.

Linux

Install the latest version on any Linux distribution:

curl -s https://get.qovery.com | bash

For security-sensitive environments, install from a pinned GitHub release and verify the downloaded archive against that release's checksums.txt. The convenience script does not perform an integrity check.

macOS

Install with Homebrew:

brew tap Qovery/qovery-cli
brew install qovery-cli

Alternatively, use the installer script:

curl -s https://get.qovery.com | bash

For a pinned, checksum-verified installation, use a GitHub release.

Windows

Install with Scoop:

scoop bucket add qovery https://github.com/Qovery/scoop-qovery-cli
scoop install qovery-cli

You can also download a release archive from GitHub Releases and add the extracted qovery executable to your PATH.

Arch Linux

The CLI is available through the AUR:

yay qovery-cli

Docker

Run the CLI without installing it locally:

docker run ghcr.io/qovery/qovery-cli:latest help

Replace latest with a specific version when you need reproducible builds.

Verify the installation

qovery version

Authentication

You can use qovery auth to authenticate with the CLI or use Q_CLI_ACCESS_TOKEN (or QOVERY_CLI_ACCESS_TOKEN) environment variable to set your API token.

Update deps

go get -u github.com/qovery/qovery-client-go
go build
go fmt .

Release a new version

Releases are cut from main by pushing a vX.Y.Z tag. mise task:

mise run release            # patch bump of latest tag
mise run release v1.170.0   # explicit version

It checks branch, clean tree and sync with origin/main, prints current tag + new tag + commits since, then asks for confirmation before pushing. The tag push triggers .github/workflows/release.yml: GitHub release + binaries, Cloudflare R2 upload, AUR package, Docker images on ECR and GHCR.