1f0f73c319
Stopping mid-Phase-3 by user request. The first child project on
admin.flndrn.com isn't done yet, so the ADMIN.md spec may change. We'll
revise this scaffold once the canonical pattern is locked in.
Committed as drafts (not deployed):
- website/ADMIN.md — manifest declaration with 4 sections
(health, community, storage, connector),
best-guess endpoint shapes, env-var token rotation
- website/src/lib/admin/api-auth.ts — Bearer auth helper with sha256 hash
compare against ADMIN_API_TOKEN_HASH env var,
in-process sliding-window rate limit, standard
{ data, meta } envelope shape
NOT yet implemented:
- 5 route handlers (/manifest + 4 sections)
- /admin/settings/api-keys stub UI
- ADMIN_API_TOKEN_HASH env var on Dokploy
- Production hard-gate curl checks
- Plaintext token sign-off
Pick up here when admin.flndrn.com canonical ADMIN.md template is ready.
Co-Authored-By: Claude Opus 4.7 (1M context) <noreply@anthropic.com>
|
||
|---|---|---|
| forge | ||
| scripts | ||
| website | ||
| .env.example | ||
| .env.migration.example | ||
| .gitignore | ||
| CLAUDE.md | ||
| CODE_OF_CONDUCT.md | ||
| CONTRIBUTING.md | ||
| docker-compose.yml | ||
| GOVERNANCE.md | ||
| LICENSE | ||
| README.md | ||
| ROADMAP.md | ||
konnos
the forge that respects your code
konnos is a community-governed, EU-rooted, self-hostable forge derived from Forgejo. It exists for teams that want sovereignty over their source code: no Microsoft, no US cloud, no surveillance, no training of external models on their commits.
Why it exists
Modern code hosting has consolidated into a handful of US-based platforms whose terms of service grant them broad rights to use your code in ways many users haven't fully agreed to in spirit. konnos is the opposite: a forge you self-host on hardware you control, in a jurisdiction you choose, under a license you can read in an evening. Data sovereignty is the entire point. GDPR is native, not a checkbox. There is no telemetry, no model training on private repos, no automatic upselling.
What's shipping today
The complete Forgejo feature set ships in v0:
- ✅ Repositories — Git over HTTPS + SSH, LFS, mirroring
- ✅ Issues, pull requests, code review, discussions
- ✅ Wiki + releases
- ✅ Forgejo Actions (drop-in compatible CI)
- ✅ Packages (npm, container, generic, …)
- ✅ Webhooks + integrations
- ✅ User and organization management
- ✅ OAuth2, SAML, LDAP
konnos's distribution layer adds:
- ✅ Opinionated Docker Compose for Dokploy
- ✅ Migration tooling from GitHub (orgs + personal repos with LFS, destination remapping)
- ✅ Custom theme — charcoal
#1b1c1e+ hot rose#FF3D7F+ white, dark-mode only - ✅ Brand assets (SVG logo, favicon, app icons) for self-hosters
Quickstart
git clone https://code.konnos.org/flndrn/konnos.git
cd konnos
cp .env.example .env # set POSTGRES_PASSWORD
docker compose up -d
Visit https://your-domain and complete the install wizard. For production setup with Dokploy + Traefik + Let's Encrypt, the docker-compose.yml in this repo is what runs code.konnos.org itself.
Governance
konnos is a BDFL project until the community grows enough to elect a maintainer council. See GOVERNANCE.md for the transition trigger (5 active contributors with 3+ merged PRs each over a rolling six-month window).
Roadmap
See ROADMAP.md. Badge convention: ✅ shipped · 🚧 in progress · 📋 planned. If a feature isn't ✅, it doesn't exist yet — write about it accordingly.
Contributing
See CONTRIBUTING.md. Every commit must be signed off with git commit -s (DCO). Code of conduct is CODE_OF_CONDUCT.md.
Look for issues labeled good first issue if you're new.
License
GPL v3+ — see LICENSE. konnos preserves Forgejo's copyright headers; new files default to GPL v3+.
Acknowledgements
konnos is a community distribution of Forgejo. Thanks to the Forgejo project and Codeberg e.V. for the upstream foundation. Without their work, konnos couldn't exist.