Skip to content

The cross-harness, self-improving memory layer for AI agents. Join our community: https://discord.com/invite/zdNChS2fBu

6.2 KB
Raw Blame
---
title: "Hosting Options"
description: "Choose between local Beacon and Beacon Cloud"
---

Run Beacon locally with full control of your data, or connect it to [Beacon Cloud](/deployment/managed) for one hosted timeline of every agent and machine, findings, sharing and MCP. Local and Beacon Cloud are free; [Beacon Cloud Pro](/deployment/plans) adds unlimited findings, memory and findings over MCP, and real-time alerts for $20 a month ($15 billed annually), and [Beacon Cloud Team](/deployment/plans#what-beacon-cloud-team-adds) gives a whole organization Pro plus a shared workspace for $30 per seat a month and a $10 base fee.

| Capability | Local | Beacon Cloud | Beacon Cloud Pro |
| --- | --- | --- | --- |
| Price | $0 | $0 | $20/mo |
| Cross-harness agent telemetry | ✓ | ✓ | ✓ |
| Local, CI & cloud collection | ✓ | ✓ | ✓ |
| Store data locally | ✓ | ✓ | ✓ |
| Forward to your own data stack | ✓ | ✓ | ✓ |
| Offline threat detection | ✓ | ✓ | ✓ |
| Hosted timeline across agents and machines | — | ✓ | ✓ |
| Share sessions by link | — | ✓ | ✓ |
| [Findings](/cloud/findings) | Local rules only | 50 included | Unlimited |
| MCP access | Local server | Session search, lenses, sharing | Plus findings, feedback and memory |
| Alerts | — | Daily digest | Real-time email |

Enterprise adds fleet rollout, approvals for risky actions, SSO, RBAC and audit logs. See [Plans and pricing](/deployment/plans) for the full comparison.

## Local

Use the open-source local path when you want endpoint telemetry without a hosted Beacon backend. Agent Beacon runs on the endpoint, writes normalized events to local JSONL, and can forward events into customer-managed security workflows.

<Tabs>
  <Tab title="macOS">
    Install Beacon with Homebrew:

    ```bash
    brew update
    brew trust asymptote-labs/tap
    brew tap asymptote-labs/tap
    brew install beacon
    beacon version
    ```

    Then configure local endpoint telemetry:

    ```bash
    beacon endpoint install
    beacon endpoint status
    ```

    See the [macOS install guide](/platforms/macos) for package and fleet deployment options.
  </Tab>
  <Tab title="Windows">
    Download `BeaconEndpointAgent-<version>-x64.msi` from the [latest release](https://github.com/asymptote-labs/agent-beacon/releases/latest), then run PowerShell as an administrator:

    ```powershell
    msiexec /i BeaconEndpointAgent-<version>-x64.msi
    & "$env:ProgramFiles\Beacon\bin\beacon.exe" endpoint status --system
    ```

    The MSI installs and starts the endpoint service. See the [Windows install guide](/platforms/windows) for silent installation and checksum verification.
  </Tab>
  <Tab title="Linux">
    Download the `.deb` or `.rpm` for your architecture from the [latest release](https://github.com/asymptote-labs/agent-beacon/releases/latest):

    <CodeGroup>
      ```bash title="Debian, Ubuntu"
      sudo apt install ./beacon_<version>_linux_amd64.deb
      beacon endpoint status --system
      ```

      ```bash title="Fedora, RHEL, Rocky, Alma"
      sudo dnf install ./beacon_<version>_linux_amd64.rpm
      beacon endpoint status --system
      ```
    </CodeGroup>

    Replace `amd64` with `arm64` on ARM systems. See the [Linux install guide](/platforms/linux) for rootless and tarball installation.
  </Tab>
</Tabs>

Open the local dashboard to inspect runtime inventory, timelines, filters, and event details:

```bash title="Open the local dashboard"
beacon endpoint dashboard --open
```

The local path preserves `runtime.jsonl` on the endpoint and supports optional forwarding to supported SIEM, observability, object-storage, local JSONL, and customer-managed destinations.

See [Local](/deployment/open-source) for setup details and [Security & IT Rollout Guide](/security) for managed endpoint deployment.

## Beacon Cloud

Use Beacon Cloud when you want hosted visibility, governance, and enterprise rollout support for agent activity.

1. [Create a Beacon account](https://beacon.sh/sign-up).
2. Sign the CLI in on each user endpoint:

```bash
beacon login
```

3. Connect the endpoint to your account:

```bash
beacon endpoint connect --dashboard-url https://beacon.sh
```

Interactive `beacon endpoint install` performs the sign-in step when needed.
System-mode connect remains account-free and uses browser approval instead.

Beacon Cloud gives you the open-source Agent Beacon experience without having to run the backend yourself.

Beacon Cloud is free. To upgrade to [Beacon Cloud Pro or Team](/deployment/plans), open
[beacon.sh/dashboard/billing](https://beacon.sh/dashboard/billing); nothing on the endpoint changes.

For cloud-hosted agent applications, install the [Observe SDK](/concepts/core-concepts#observe-sdk) and initialize hosted export with a Beacon API key:

```bash title="Set the hosted Observe API key"
export ASYMPTOTE_API_KEY=...
```

```typescript title="Initialize hosted Observe"
import { Observe } from "@asymptote/sdk";

Observe.initialize({
  apiKey: process.env.ASYMPTOTE_API_KEY,
});
```

See [Beacon Cloud](/deployment/managed) for managed platform capabilities and [SDK Quickstart](/sdk/quickstart) for cloud instrumentation details.

## Related

<Columns cols={2}>
  <Card title="Plans and pricing" icon="tag" href="/deployment/plans">
    Compare Open Source, Beacon Cloud, Beacon Cloud Pro and Enterprise.
  </Card>
  <Card title="Beacon Cloud" icon="key" href="/deployment/managed">
    Review managed ingest, governance, investigations, access control, and rollout support.
  </Card>
  <Card title="Local" icon="download" href="/deployment/open-source">
    Install Beacon, configure endpoint telemetry, and keep the CLI up to date.
  </Card>
  <Card title="Quickstart" icon="rocket" href="/get-started/quickstart">
    Choose the right path for a local or managed rollout.
  </Card>
  <Card title="Beacon Observe SDK" icon="code" href="/sdk/quickstart">
    Instrument cloud-hosted agent applications with hosted or customer-managed export.
  </Card>
  <Card title="Beacon Overview" icon="diagram-project" href="/get-started/overview">
    See how local Beacon fits with Beacon Cloud.
  </Card>
  <Card title="Log Forwarding" icon="tower-broadcast" href="/log-forwarding">
    Forward local Beacon events into security and observability platforms.
  </Card>
</Columns>