qovery auth

Overview

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

Commands

Authenticate with Qovery interactively:

qovery auth

This will open your browser to complete the authentication flow. 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. 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.

Token

Output the current valid access token (refreshing it if expired). Useful for making direct API calls to the Qovery API. For security reasons, the token is not printed by default. You must explicitly use --print or --json to output the token value.

qovery auth token [flags]

Flags:

--print — Print the raw access token value to stdout
--json — Output as JSON with token, type, expiration, and API URL
--authorization-header — Output the full Authorization header value (e.g., Bearer eyJ...)

Examples:

# Print the raw token value
qovery auth token --print

# Use directly in a curl command
curl -H "Authorization: Bearer $(qovery auth token --print)" \
  https://api.qovery.com/organization

# Print the full Authorization header value
qovery auth token --print --authorization-header

# Get structured JSON output
qovery auth token --json

Examples

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

Options

Flag	Description
`--headless`	Headless mode for environments without a browser (provides URL to copy/paste)
`--skipVersionCheck`	Skip CLI version check during authentication
`--help`	Show help for auth command

qovery api - Make authenticated HTTP requests to the Qovery API
qovery context - Manage CLI context

Getting Started

Commands

Troubleshooting

Overview

Commands

Token

Examples

Headless Authentication

CI/CD Authentication

Server/Remote Authentication

Options

​Overview

​Commands

​Login

​Headless Login

​Login with API Token

​Token

​Examples

​Interactive Login

​Headless Authentication

​CI/CD Authentication

​Server/Remote Authentication

​Options

​Related Commands

Overview

Commands

Login

Headless Login

Login with API Token

Token

Examples

Interactive Login

Headless Authentication

CI/CD Authentication

Server/Remote Authentication

Options

Related Commands