Authentication - Groniz Documentation

OAuth2 (Recommended)

Authenticate using the device flow — no client ID or secret needed:

groniz auth:login

This will:

# Check current auth status (verifies credentials are still valid)
groniz auth:status

# Remove stored credentials
groniz auth:logout

Alternatively, set your Groniz API key as an environment variable:

export GRONIZ_API_KEY=your_api_key_here

You can get your API key from the Groniz Settings page.

OAuth2 credentials take priority over the API key when both are present.

Variable	Required	Default	Description
`GRONIZ_API_KEY`	No*	-	Your Groniz API key
`GRONIZ_API_URL`	No	`https://api.groniz.com`	API endpoint override
`GRONIZ_AUTH_SERVER`	No	`https://api.groniz.com`	Auth server override

*Either OAuth2 (via groniz auth:login) or GRONIZ_API_KEY is required.

⌘I