baseguard login
Authenticate and register your device
The login command authenticates your device with the control plane and registers it with your organization.
Note: You usually don't need to run this command directly.
baseguard connectautomatically triggers login if you're not authenticated.
Usage
baseguard login [options]Options
| Option | Description |
|---|---|
--url <url> | Custom control plane URL (e.g., https://api.baseguard.net) |
--auth-key <key> | Pre-authorized authentication key |
Interactive Login
Without an auth key, login uses the device authorization flow:
$ baseguard login
Please authorize your device.
https://console.baseguard.net/account/node-auth/xxxxx- Open the displayed URL in a browser
- Log in with your credentials (if needed)
- Review the device information
- Click Authorize
The CLI will detect authorization and complete login:
Authorization complete.Using Auth Keys
For automated or headless setups, use a pre-authorized auth key:
baseguard login --auth-key bgauth_xxxxxxxxxxxxxxxxxxxxThis skips the interactive browser flow. See Node Auth Keys for how to create them.
Custom Control Plane URL
For self-hosted or multi-environment setups:
baseguard login --url https://api.mycompany.baseguard.netTroubleshooting
See Troubleshooting — Authentication & Login Issues for solutions to daemon, authorization URL, timeout, and auth key problems.
See Also
logout— Log out and remove credentialsconnect— Connect to the network- Node Auth Keys — Creating auth keys