Authentication Commands

Complete reference for authentication, config inspection, and credential profile management commands.

Core Commands

auth login

Authenticate with browser auth or an API key. Use --profile to save credentials under a named profile.

scalebox-cli auth login --profile staging --api-key sk-your-key --server-url https://api.scalebox.dev

auth whoami

Show the resolved profile and the current authenticated user.

scalebox-cli auth whoami

auth config

Show the config file path, active profile, and current server details.

scalebox-cli auth config

auth logout

Remove stored authentication credentials for the active profile. Other saved profiles remain; use auth profile remove to delete a specific profile.

scalebox-cli auth logout

Profile Management

auth profile list

List stored credential profiles and mark the active one.

scalebox-cli auth profile list

auth profile use PROFILE_NAME

Switch the active stored profile without logging in again.

scalebox-cli auth profile use prod

auth profile remove PROFILE_NAME

Remove one stored profile from ~/.scalebox-cli/config.json.

scalebox-cli auth profile remove old-staging

Profile Selection

When you do not pass an explicit profile, the CLI resolves credentials in this order:

1. Root --profile
2. SCALEBOX_PROFILE
3. current_profile in ~/.scalebox-cli/config.json

scalebox-cli --profile prod sandbox list