qovery auth

Authentication commands for Qovery CLI

Overview

The auth command handles authentication with Qovery. You can authenticate using interactive login or API tokens.

Commands

Login

Authenticate with Qovery interactively:

qovery auth

This will open your browser to complete the authentication flow.

Headless Login

For environments without a browser (CI/CD, servers), use headless mode:

qovery auth --headless

This will provide a URL that you can open manually to complete authentication.

Login with API Token

Set your API token as an environment variable:

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

You can generate an API token from the Qovery Console under Settings → API Tokens.

Logout

Clear authentication credentials:

qovery auth logout

Examples

Interactive Login

qovery auth
# Opens browser for authentication
# Credentials saved locally

Headless Authentication

qovery auth --headless
# Displays URL: https://auth.qovery.com/...
# Copy and paste URL in a browser
# Complete authentication manually

CI/CD Authentication

# In your CI/CD environment
export QOVERY_CLI_ACCESS_TOKEN="${{ secrets.QOVERY_TOKEN }}"
qovery auth
qovery application deploy --application "my-app"

Server/Remote Authentication

# On a remote server without browser
qovery auth --headless
# Copy the displayed URL
# Open URL on your local machine
# Authentication will be saved on the server

Switch Accounts

# Logout from current account
qovery auth logout

# Login with different account
qovery auth

Options

Flag	Description
--headless	Headless mode for environments without a browser (provides URL to copy/paste)
--help	Show help for auth command

Related Commands

• qovery context - Manage CLI context