Skip to main content

​
Command Overview

beacon endpoint onboarding inspects the one-time onboarding record written the first time beacon endpoint install runs in a terminal.
Command syntax
The record lives in ~/.beacon/profile.json. It survives uninstall, so reinstalling Beacon does not ask again.

​
First-run onboarding

The first interactive beacon endpoint install asks two questions — how you are using Beacon, and your email — and sends the answers to Asymptote once. This is how we decide which agent runtimes and integrations to build next. What is sent, and nothing else: Prompts, file contents, commands, telemetry events, and repository names are never sent. The endpoint agent itself stays local-only; this is one request at install time, not an ongoing channel. The prompt never appears non-interactively. Package postinstall scripts, MDM deployments, --system installs, CI, --dry-run, and any piped or redirected stdin skip it silently.

​
Flags

​
Unattended installs

Set BEACON_ONBOARDING=0 to suppress the prompt on an install that would otherwise be interactive. There is no CLI flag for this: it exists for unattended CI and MDM workflows.
Suppress the prompt
For a fleet rollout where you do want attribution but have no terminal, supply both answers up front and Beacon records them without prompting:
Headless attribution for MDM
BEACON_ONBOARDING_USAGE accepts work, personal, or evaluating. An invalid value is reported on stderr and ignored rather than failing the install.

​
Examples

Show what was recorded:
Show the onboarding record
Clear it so the next install asks again:
Reset the onboarding record
Retry a submission that could not reach Asymptote. A failed submission never fails an install; the payload is kept and retried automatically on the next install or repair.
Resend a queued signup
To have your record deleted, email the install ID shown by this command to support@asymptotelabs.ai.

Endpoint install

Configure endpoint telemetry and collector service files.

Endpoint config

Inspect, validate, and update endpoint configuration.