Docs

How to run konnos.

For now, docs live next to the code. A dedicated docs.konnos.org site lands in v0.2 — see ROADMAP.

Self-host

Run konnos on your own infrastructure: Dokploy + Traefik + Let's Encrypt is the primary path. The same docker-compose.yml runs code.konnos.org itself.

→ docker-compose.yml

Migrate from GitHub

Single bash script moves orgs + personal repos with LFS, with destination remapping for org consolidation. NDJSON log, idempotent on re-run.

→ scripts/migrate-github-to-konnos.sh

Project layout

What lives in the repo and where: forge/ for the distribution layer, scripts/ for tooling, website/ for konnos.org, docs/ for guides.

→ CLAUDE.md (project source-of-truth)

Quickstart

Four lines on a Linux box with Docker installed. Opinionated defaults, batteries-included.

git clone https://code.konnos.org/konnos/konnos.git
cd konnos
cp .env.example .env   # edit POSTGRES_PASSWORD
docker compose up -d

For production deployment with Dokploy + Traefik + Let’s Encrypt (the same path that runs code.konnos.org itself), see the full repository.