Installation

Hivekeep runs as a single process with an embedded SQLite database. No Postgres, no Redis, no external dependencies.

Docker (recommended)

docker run -d --name hivekeep \
  -p 3000:3000 \
  -v hivekeep-data:/app/data \
  ghcr.io/marlburrow/hivekeep:latest

Open http://localhost:3000 and Queenie, your setup guide, handles the rest.

One-liner script (Linux / macOS)

curl -fsSL https://raw.githubusercontent.com/MarlBurroW/hivekeep/main/install.sh | bash

This will:

1. Install Bun if not present
2. Clone the repository to /opt/hivekeep
3. Install dependencies and build the frontend
4. Run database migrations
5. Create a system service (systemd on Linux, launchd on macOS)
6. Start Hivekeep on port 3000

Customizing the install

HIVEKEEP_DIR=/home/me/hivekeep \
HIVEKEEP_DATA_DIR=/home/me/hivekeep-data \
HIVEKEEP_PORT=8080 \
  bash <(curl -fsSL https://raw.githubusercontent.com/MarlBurroW/hivekeep/main/install.sh)

Docker Compose

git clone https://github.com/MarlBurroW/hivekeep.git
cd hivekeep/docker
ENCRYPTION_KEY=$(openssl rand -hex 32) docker compose up -d

See docker/docker-compose.yml for all options.

Manual install

git clone https://github.com/MarlBurroW/hivekeep.git
cd hivekeep
bun install
bun run build
bun run db:migrate
NODE_ENV=production bun run start

Prerequisites

• Bun >= 1.0
• Git

What’s next?

Head to First Agent to create your first AI agent.