AuthenticationAuthentication

Connect a provider

RunInfra is the default provider. Get its key at runinfra.ai/settings/api-keys (sign-in required), then start RightNow:

rightnow

If the selected provider has no usable credential, the Connect screen opens. Choose the provider and paste its key. The key is masked while you type; RightNow validates it with the provider before storing it. Use /connect to reopen the screen in a session.

Stored keys live in auth.json under the effective product home. RIGHTNOW_AUTH_PATH selects a different credential file.

Environment variables

Set the provider variable in the terminal you will use to launch RightNow. These are templates: replace <your key> before running the command for your platform.

Windows PowerShell

$env:RIGHTNOW_API_KEY = "<your key>"

macOS (zsh)

export RIGHTNOW_API_KEY='<your key>'

Linux (bash)

export RIGHTNOW_API_KEY='<your key>'

A nonempty provider environment variable overrides its stored key. For RunInfra, RIGHTNOW_API_KEY takes priority over RUNINFRA_GATEWAY_KEY.

Configuration files

The effective product home is the directory RightNow uses for user configuration and stored state. RIGHTNOW_HOME can override it; these are the default user configuration paths for a new installation:

In configuration, model_provider selects a provider ID and env_key names the environment variable that supplies its key. Keep the key in the environment or auth store. See Providers for model entries and provider configuration.

Manage stored credentials

Start the credential flow from your shell:

rightnow auth login

For scripts, --with-api-key reads the key from standard input. Supply the key on stdin instead of putting it in a command argument.

Inspect configured, environment and stored credential sources:

rightnow auth list

Check the provider, model and credential source in use:

rightnow auth status

To remove only RunInfra's stored key, run this separately:

rightnow auth logout runinfra

If set, the provider environment variable remains active after logout.