> ## Documentation Index
> Fetch the complete documentation index at: https://bollyai.dev/docs/llms.txt
> Use this file to discover all available pages before exploring further.

# One-Line Install

> Install Bolly on Linux or macOS with a single command

The fastest way to get Bolly running. A single curl command downloads the latest binary, creates your config, and sets up a background service.

## Install

```bash theme={null}
curl -fsSL https://bollyai.dev/install.sh | bash
```

This script will:

1. Detect your operating system and architecture
2. Download the latest Bolly binary from GitHub releases
3. Place it in a system-accessible location
4. Create the default config directory at `~/.bolly/`
5. Generate a default `config.toml`
6. Set up a background service (systemd on Linux, launchd on macOS)

<Info>The install script is open source. You can [review it on GitHub](https://github.com/triangle-int/bolly) before running.</Info>

## Open Bolly

The install script starts the service automatically. Open [http://localhost:26559](http://localhost:26559) in your browser — Bolly will guide you through the initial setup.

During onboarding you'll choose your AI provider:

* **API Key** — bring your own Anthropic key from [console.anthropic.com](https://console.anthropic.com). Pay per usage.
* **Claude Code** — use your Claude subscription via OAuth login. Requires [extra usage](https://console.anthropic.com/settings/billing) enabled.
* **OpenAI** — bring your own OpenAI key. Pay per usage.
* **Codex** — use your ChatGPT subscription via BYOKEY proxy.

<Info>See the [API Keys guide](/docs/installation/api-keys) for details on all options.</Info>

## Managing the service

### Check status

```bash theme={null}
bolly status
```

### Stop the service

```bash theme={null}
bolly stop
```

### Start / restart

```bash theme={null}
bolly start
bolly restart
```

### View logs

```bash theme={null}
bolly logs
```

<Info>The `bolly` CLI wraps platform-specific service management (`launchd` on macOS, `systemd` on Linux) so you don't have to remember the underlying commands.</Info>

## Updating

To update Bolly to the latest version, run the install script again:

```bash theme={null}
curl -fsSL https://bollyai.dev/install.sh | bash
```

The script detects existing installations and performs an in-place upgrade while preserving your config and data. See the [full updating guide](/docs/installation/updating) for the built-in update command and release channels.

## Uninstalling

Run the uninstall script to remove Bolly:

```bash theme={null}
curl -fsSL https://bollyai.dev/uninstall.sh | bash
```

This stops the service, removes the binary and service files, and cleans up your PATH. See the [full uninstall guide](/docs/installation/uninstall) for options like keeping your data.

## Next steps

<CardGroup cols={2}>
  <Card title="Configuration" icon="gear" href="/docs/installation/configuration">
    Customize personality, heartbeat, and memory settings.
  </Card>

  <Card title="API Keys" icon="key" href="/docs/installation/api-keys">
    Learn about optional integrations like Google AI and ElevenLabs.
  </Card>
</CardGroup>