Skip to main content

​
Command overview

beacon endpoint uninstall unloads the local Beacon service and removes managed endpoint files.
Command syntax
Use retention flags when you want to keep local evidence or preserve harness telemetry configuration.

​
Flags

​
Examples

Remove the default per-user install:
Remove the default per-user install
Remove Beacon but keep runtime logs:
Remove Beacon but keep runtime logs
Remove Beacon but keep harness telemetry configuration:
Remove Beacon but keep harness telemetry configuration
Keep both logs and harness configuration:
Keep both logs and harness configuration
Remove a system-mode deployment:
Remove a system-mode deployment

​
Removed paths

Beacon removes files listed in its install manifest, including managed config, collector config, and service files. Unless --keep-logs is set, it also removes the configured runtime JSONL log. If the endpoint was connected to Beacon managed ingest, uninstall also stops and removes the com.beacon.endpoint.asymptote-forwarder service (or beacon-asymptote-forwarder.service) and the asymptote/ directory holding the Vector config, buffer, enrollment record and device key; --keep-config keeps the enrollment record and key. The device stays registered server-side until it is revoked from the dashboard’s Beacon Endpoints page.

Endpoint install

Reinstall the local endpoint collector and runtime telemetry.

Endpoint status

Check endpoint state before or after uninstalling.