> ## 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.

# Install Beacon

> Install the Beacon CLI with Homebrew or platform archives

## Homebrew

Install the Beacon CLI with Homebrew:

```bash title="Install Beacon" theme={null}
brew tap asymptote-labs/tap
brew install beacon
beacon version
```

<Accordion title="Example output">
  ```bash title="beacon version output" theme={null}
  $ beacon version
  beacon version 0.0.66
  ```
</Accordion>

## Other install methods

Beacon releases publish macOS and Linux archives for `amd64` and `arm64` alongside Homebrew builds. For archive-based installs or source builds, see [Manual CLI Installation](/cli/manual-install).

Apple Silicon endpoint package releases are attached to GitHub Releases as
signed, notarized, and stapled `.pkg` assets for MDM or manual system installs.
Use those package assets when you want `/opt/beacon`, the local collector
LaunchDaemon, and the bundled Vector forwarder helpers installed together.

## Next steps

After installing Beacon, configure the workflow you need:

<Columns cols={2}>
  <Card title="Endpoint telemetry" icon="satellite-dish" href="/cli/endpoint-install">
    Configure local agent harness telemetry.
  </Card>

  <Card title="Cloud agent telemetry" icon="cloud" href="/cli/cloud">
    Configure provider-managed cloud agent telemetry setup helpers.
  </Card>

  <Card title="CI telemetry" icon="terminal" href="/cli/ci">
    Run ephemeral AI runtime telemetry collection in CI.
  </Card>

  <Card title="Upgrade Beacon" icon="arrow-up" href="/cli/upgrade">
    Keep the Beacon CLI up to date.
  </Card>
</Columns>