Skip to main content
Get Kioku running locally in 5 minutes.
1

Prerequisites

2

Clone and setup

git clone https://github.com/kioku-org/kioku.git
cd kioku/deployment/docker

# Copies .env.example, generates secure secrets, pulls images
./scripts/setup.sh
3

Configure environment

# Required — set your Vexa admin token
$EDITOR .env

# Optional — add API keys for integrations
# OPENAI_API_KEY=...
# ANTHROPIC_API_KEY=...
# ZOOM_CLIENT_ID=...
# ZOOM_CLIENT_SECRET=...
4

Start the stack

./scripts/manage.sh start
This starts stateful services (Postgres, Qdrant) first, then all stateless services (Hivemind, Vexa, Ollama, etc.).
5

Verify health

./scripts/healthcheck.sh
All services should show green checkmarks.
6

Install CLI

cd ../../apps/cli
cargo install --path crates/cc-cli

# Sign in (create an admin account first via API)
kioku signin

​
Services

ServicePortDescription
Hivemind API9100Core API (auth, sessions, knowledge search, MCP)
Vexa API Gateway8056Meeting bot API
Vexa Admin API8057Admin operations
MinIO Console9001Object storage UI
Ollama11434Local embedding model server
Qdrant6333Vector DB REST API

​
Management

./scripts/manage.sh status          # running containers + resource usage
./scripts/manage.sh logs <service>  # tail logs (e.g. logs kioku-hivemind)
./scripts/manage.sh stop            # stop all (data preserved)
./scripts/manage.sh down            # stop and remove containers
./scripts/manage.sh down-volumes    # ⚠ destroy ALL data
./scripts/manage.sh backup          # dump databases to backups/
./scripts/manage.sh restore <file>  # restore from backup