Baseguard

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 connect automatically triggers login if you're not authenticated.

Usage

baseguard login [options]

Options

OptionDescription
--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
  1. Open the displayed URL in a browser
  2. Log in with your credentials (if needed)
  3. Review the device information
  4. 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_xxxxxxxxxxxxxxxxxxxx

This 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.net

Troubleshooting

See Troubleshooting — Authentication & Login Issues for solutions to daemon, authorization URL, timeout, and auth key problems.

See Also

On this page