Skip to main content
Bolly supports multiple installation methods depending on your use case. All methods are self-hosted — your data stays on your machine.

Installation Methods

System Requirements

Minimum Hardware

  • 2 CPU cores
  • 2 GB RAM
  • 500 MB disk space (plus storage for memory/drops)
  • Internet connection (for LLM API calls)

Supported Platforms

  • Linux: x86_64, aarch64 (Ubuntu 20.04+, Debian 11+, Fedora 36+, Arch)
  • macOS: Apple Silicon (M1+, macOS 12+)
  • Windows: x86_64 (Windows 10+, desktop app only)
  • Docker: Any platform with Docker Engine 20+

Required API Keys

Bolly uses a BYOK (Bring Your Own Key) model. You need at minimum:
See the API Keys guide for detailed setup instructions for each provider.

Data Directory

All Bolly data lives in ~/.bolly/ by default (configurable via BOLLY_HOME environment variable):

What’s Next

Pick your installation method and follow the guide:

One-Line Install

The fastest path — a single curl command.

Docker

Containerized deployment with persistent volumes.

Desktop App

Native app with computer use support.

From Source

Build everything from the repository.