Documentation

Everything you need to ship on konnos

Open-source, privacy-first Git hosting. These guides cover the whole loop — make a repository, push your code, track work, and automate it — using only features that ship today.

New here? Start with Getting started — it takes you from an empty repository to your first push in a few minutes. Everything else is a reference you can dip into when you need it.

Getting started

Create a repository, then push and clone your code — over HTTPS with a token, or over SSH with a key.

Repositories

Create a repo, browse its files and commits, and delete one when you're done (with a guard so it's never an accident).

Issues

Open an issue, discuss it in comments, and close it when it's fixed.

Organisations & teams

Group work under a shared org so a project isn't tied to one person.

Personal Access Tokens

Your password stand-in for git-over-HTTPS, the API, and the MCP. Shown once, revocable.

Sign in with Konnos

OAuth provider for your products: authorize screen, token exchange, userinfo, and SuperTokens-style config.

Packages

Publish versioned files with curl — a simple alternative to a full container registry.

SSH keys

How key pairs work, register a public key, push over SSH, and connect project agents.

Webhooks

Have konnos POST to your own URL when things happen — create, list, and delete them per repo.

Actions (CI)

Self-hosted runners, workflows on push/PR, logs, secrets, cancel and re-run.

The MCP phone line

Let your apps and AI agents call konnos mid-build — create repos, push files, open issues, and more.

API reference

The REST API: mint a token, then create and manage repositories and issues over plain HTTPS.

Migrate to konnos

Leave Codeberg (or any host): import wizard, mirror push, and click-by-click next steps. Full history, your continent.