Skip to main content

​
Command Overview

Authenticate the Beacon CLI with your Asymptote dashboard account. The command opens a browser-based authorization flow and saves credentials for Beacon features that need dashboard access.
Command syntax
beacon login [flags]
Example output
$ beacon login

Opening browser to https://asymptotelabs.ai/cli/auth...
Waiting for authentication...

Success! Logged in as justin@acme.com
Organization: Acme Corp

Beacon endpoint telemetry remains local-only unless you explicitly use cloud features.
If the browser cannot be opened automatically, Beacon prints the authorization URL so you can open it manually. Credentials are stored in ~/.beacon/auth/credentials.json with user-only file permissions.
Logging in does not change local endpoint telemetry collection. Beacon endpoint telemetry remains local-only unless you explicitly configure cloud features.

​
Existing sessions

When valid credentials already exist, beacon login prints the saved account and organization instead of replacing them:
Existing session
$ beacon login
Already logged in as justin@acme.com
Organization: Acme Corp
Run 'beacon login --force' to log in as a different user.
Use --force when you need to replace saved credentials.

​
Flags

FlagDescription
--dashboard-url <url>Asymptote dashboard URL. Defaults to https://asymptotelabs.ai, or the value of BEACON_DASHBOARD_URL.
--forceReplace existing saved credentials.
-h, --helpHelp for login

beacon cloud

Configure cloud-agent telemetry features that may use dashboard authentication.

beacon version

Check your installed Beacon CLI version.