Quick start (Docker)

Covey runs as a single binary next to a Postgres database. For a local end-to-end slice, Docker and a few steps are enough.

Prerequisites

• Docker (with the Docker daemon)
• A master key for secret encryption

Steps

1. Start the database — a Postgres container with the pgvector extension enabled.
2. Migrations run automatically at serve start (auto-migrate with an advisory lock).
3. Bootstrap creates the first organization and an admin user.
4. Start the server — the control plane serves the API and the embedded web UI on the same port.

make dev-db      # provision Postgres
make bootstrap   # create org + admin
make run         # start the control plane

Sign in

The web UI is embedded in the binary (no separate web server). After starting, sign in with the bootstrap credentials and create your first agent from a template.