Documentation

Everything you need to ship on konnos

Open-source, privacy-first Git hosting. These docs are growing alongside the product — but the path from zero to your first push is already here, plus references for the MCP server and REST API.

Quick start

From zero to your first push

konnos is plain Git underneath, so there's nothing new to learn. Four steps and your code is home.

  1. 1

    Create your account

    Sign up for free. Every repository you make is private by default — nothing is visible until you choose to open it.

  2. 2

    Create a repository

    Hit New repository on code.konnos.org, give it a name, and leave it private. You'll land on an empty repo with its clone URL ready to copy.

  3. 3

    Point your project at it

    In an existing project, add konnos as your remote:

    git remote add origin https://code.konnos.org/<you>/<repo>.git
  4. 4

    Push your code

    Send your first branch up. That's it — your code is now hosted on konnos.

    git push -u origin main

Pushing over HTTPS will ask for your username and an access token (not your password). See the API reference for how to mint one.

Ready to bring your code home?

Start free in minutes — or explore the API and MCP references first.