Authentication

The CLI requires authentication to interact with your Controlinfra account.

Login

Browser Authentication (Recommended)

The simplest way to authenticate is through your browser:

controlinfra login

This will:

1. Open your default browser to the Controlinfra login page
2. After you authenticate, the CLI will automatically receive your credentials
3. Your session will be saved locally for future use

API Token Authentication

For CI/CD environments or headless servers, use an API token:

controlinfra login --token <your-api-token>

You can generate API tokens from your account settings.

Environment Variable

You can also set your token as an environment variable:

export CONTROLINFRA_TOKEN=your-api-token
controlinfra repos list

Check Current User

Verify you're logged in and see your account details:

controlinfra whoami

Output:

┌──────────────────────────────────────────────────────────┐
│ Current User                                             │
├──────────────────────────────────────────────────────────┤
│ Email:       john@example.com                            │
│ Name:        John Doe                                    │
│ Role:        admin                                       │
│ Workspace:   My Team                                     │
└──────────────────────────────────────────────────────────┘

Logout

To clear your stored credentials:

controlinfra logout

Configuration Storage

Credentials are stored securely in:

Platform	Location
Linux	~/.config/controlinfra-nodejs/config.json
macOS	~/Library/Preferences/controlinfra-nodejs/config.json
Windows	%APPDATA%\controlinfra-nodejs\Config\config.json

Custom API URL

For self-hosted installations, you can set a custom API URL:

export CONTROLINFRA_API_URL=https://your-instance.example.com
controlinfra login

Next Steps

• Quick Reference - Common commands
• Repositories - Managing repositories