Qovery CLI

Overview

The Qovery CLI (Command Line Interface) enables you to interact with Qovery directly from your terminal. Deploy applications, manage environments, stream logs, and more - all without leaving your command line.

Installation

Linux
MacOS
Windows
Docker

*nix
Arch Linux
Manual

To download and install Qovery CLI on any Linux distribution:

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

The install script does not verify the binary’s integrity. For security-sensitive environments, use the Manual tab to download a pinned release and verify its checksum against the official checksums.txt published with each release.

Qovery is part of AUR packages, so you can install it with yay:

yay qovery-cli

Install the Qovery CLI on Linux manually from a pinned release to ensure you control what version is installed.Replace X.Y.Z with the version you want to install:

VERSION=1.48.0  # version number without the 'v' prefix
ARCH=amd64      # use arm64 for ARM64
ARCHIVE="qovery-cli_${VERSION}_linux_${ARCH}.tar.gz"

# Download the binary and checksums for your platform
curl -sL "https://github.com/Qovery/qovery-cli/releases/download/v${VERSION}/${ARCHIVE}" -o "${ARCHIVE}"
curl -sL "https://github.com/Qovery/qovery-cli/releases/download/v${VERSION}/checksums.txt" -o checksums.txt

# Verify the checksum of the downloaded file only (fails if tampered)
grep "${ARCHIVE}" checksums.txt | sha256sum --check

# Extract and install
tar -xzf "${ARCHIVE}"
mv qovery /usr/local/bin/qovery
chmod +x /usr/local/bin/qovery

Homebrew
Script
Manual

The common solution to install a command line binary on the MacOS is to use Homebrew.

# Add Qovery brew repository
brew tap Qovery/qovery-cli

# Install the CLI
brew install qovery-cli

To download and install Qovery CLI from the command line:

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

Install the Qovery CLI on macOS manually from a pinned release to ensure you control what version is installed.Replace X.Y.Z with the version you want to install:

VERSION=1.48.0  # version number without the 'v' prefix
ARCH=amd64      # use arm64 for Apple Silicon (M1/M2/M3)
ARCHIVE="qovery-cli_${VERSION}_darwin_${ARCH}.tar.gz"

# Download the binary and checksums for your platform
curl -sL "https://github.com/Qovery/qovery-cli/releases/download/v${VERSION}/${ARCHIVE}" -o "${ARCHIVE}"
curl -sL "https://github.com/Qovery/qovery-cli/releases/download/v${VERSION}/checksums.txt" -o checksums.txt

# Verify the checksum of the downloaded file only (fails if tampered)
grep "${ARCHIVE}" checksums.txt | shasum -a 256 --check

# Extract and install
tar -xzf "${ARCHIVE}"
mv qovery /usr/local/bin/qovery
chmod +x /usr/local/bin/qovery

Scoop
Manual

The classic way to install binaries on Windows is to use Scoop.

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

# Install the CLI
scoop install qovery-cli

Install the Qovery CLI on Windows manually by downloading the latest release, and uncompress its content to C:\Windows.

Install Docker on your local machine and run the following command:

# Pull and Run the latest Qovery CLI
docker run ghcr.io/qovery/qovery-cli:latest help

Change latest by the version you want to use. For example, to use the version 0.58.4, run:

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

ghcr.io is the GitHub Container Registry.

Verify Installation

qovery version

Authentication

Before using the CLI, you need to authenticate:

qovery auth

This will open a browser window for authentication. Once completed, you’ll be ready to use the CLI.

API Token Authentication

You can also authenticate using an API token:

export QOVERY_CLI_ACCESS_TOKEN="your-api-token"
qovery auth

Generate an API token from the Qovery Console.

Configuration

The CLI stores configuration in ~/.qovery/context.json. You can manage multiple contexts for different organizations or clusters.

Set Default Context

qovery context set

List Contexts

qovery context list

Watching Operations

Most deployment commands accept the --watch (-w) flag to wait until the targeted services finish and report their final status. The command exits with a non-zero status if a watched service fails, is canceled, ends in an unexpected state, or no longer exists — useful in CI/CD pipelines. By default, a watch stops after 1 hour and exits with an error if the services have not finished. To wait longer (for example for long builds or Terraform runs), set the QOVERY_CLI_WATCH_TIMEOUT environment variable to a Go duration such as 2h:

export QOVERY_CLI_WATCH_TIMEOUT="2h"
qovery environment deploy --watch

Key Features

Deploy Applications

Deploy and redeploy applications instantly from the terminal

Environment Management

Create, update, and manage environments

Live Logs

Stream real-time logs from your applications

Shell Access

Execute commands directly in running containers

Quick Start

List Projects

qovery project list

List Environments

qovery environment list

Deploy an Application

qovery application deploy

View Logs

qovery log

Next Steps

CLI Commands

Explore all available commands and examples

Getting Started

Commands

Troubleshooting

Overview

Installation

Verify Installation

Authentication

API Token Authentication

Configuration

Set Default Context

List Contexts

Watching Operations

Key Features

Deploy Applications

Environment Management

Live Logs

Shell Access

Quick Start

List Projects

List Environments

Deploy an Application

View Logs

Next Steps

CLI Commands

Your entire infrastructure, one terminal command away

​Overview

​Installation

​Verify Installation

​Authentication

​API Token Authentication

​Configuration

​Set Default Context

​List Contexts

​Watching Operations

​Key Features

Deploy Applications

Environment Management

Live Logs

Shell Access

​Quick Start

​List Projects

​List Environments

​Deploy an Application

​View Logs

​Next Steps

CLI Commands

​Your entire infrastructure, one terminal command away

Overview

Installation

Verify Installation

Authentication

API Token Authentication

Configuration

Set Default Context

List Contexts

Watching Operations

Key Features

Quick Start

List Projects

List Environments

Deploy an Application

View Logs

Next Steps

Your entire infrastructure, one terminal command away