Qovery CLI

Manage your Qovery infrastructure from the command line

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

*nix

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.

Arch Linux

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

yay qovery-cli

Manual

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

MacOS

Homebrew

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

Script

To download and install Qovery CLI from the command line:

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.

Manual

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

Windows

Scoop

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

Manual

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

Docker

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

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