Skip to main content

​
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

FlagDescription
--headlessHeadless mode for environments without a browser (provides URL to copy/paste)
--helpShow help for auth command