> ## Documentation Index
> Fetch the complete documentation index at: https://asymptotelabs-fix-postinstall-refresh-user-hooks.mintlify.site/llms.txt
> Use this file to discover all available pages before exploring further.

# Manual CLI Installation

> Install the Beacon CLI from platform archives or build it from source

## Archive Collection

Beacon releases publish platform archives for macOS and Linux on `amd64` and `arm64`. Each archive includes the `beacon` CLI and the matching `beacon-otelcol` collector binary, with SHA-256 checksums published alongside the release.

For managed endpoint rollouts on Apple Silicon Macs, GitHub Releases also attach
a signed, notarized, and stapled `BeaconEndpointAgent-<version>-arm64.pkg`. The
package installs Beacon under `/opt/beacon`, includes the collector and Vector
binary, and is intended for MDM or root-managed system deployments rather than
per-user CLI installs.

## Build from source

To build the CLI directly from the Beacon repository:

```bash title="Build Beacon from source" theme={null}
git clone https://github.com/Asymptote-Labs/agent-beacon.git
cd agent-beacon/cli/beacon
make build
```

## Related

<Columns cols={2}>
  <Card title="Install Beacon" icon="download" href="/cli/install">
    Install Beacon with Homebrew.
  </Card>

  <Card title="Endpoint telemetry" icon="satellite-dish" href="/cli/endpoint-install">
    Configure local agent harness telemetry after installing the CLI.
  </Card>
</Columns>