Getting started

From zero to your first push

konnos is plain Git underneath, so there's nothing new to learn. Make a repository, point your project at it, and push. You can connect two ways — over HTTPS with a token, or over SSH with a key.

1 · Create a repository

You need somewhere for your code to live. There are two ways to make one:

  • In the dashboard — open your dashboard, click New repository, give it a name, and leave it private. You land on an empty repo with its clone URL ready to copy. Full walkthrough in Repositories.
  • From an agent or script — the MCP phone line and the REST API can both create a repository for you, so a build can make its own home before it pushes.

Private by default

Every repository you make is private until you choose to open it — nothing is visible to anyone else in the meantime.

2 · Push over HTTPS (username + token)

The quickest way to connect. When git asks for a password over HTTPS, you paste a Personal Access Token — not your account password. Mint one first (see Personal Access Tokens), then:

Push an existing project:

# inside your project folder
git remote add origin https://code.konnos.org/<you>/<repo>.git
git push -u origin main

# git will prompt:
#   Username: <you>
#   Password: <paste your Personal Access Token>

Or clone one that already exists:

git clone https://code.konnos.org/<you>/<repo>.git

Tired of pasting the token?

Let git remember it in your OS keychain so you paste it just once:

git config --global credential.helper store

3 · Push over SSH (add a key)

SSH uses a key pair — a private key that stays on your machine and a public key you hand to konnos — so you never type anything after setup. Full walkthrough in SSH keys; the short version:

  1. 1

    Create a key (if you don't have one)

    ssh-keygen -t ed25519 -C "you@example.com"

    Press Enter to accept the defaults. This writes ~/.ssh/id_ed25519 (private — keep it) and ~/.ssh/id_ed25519.pub (public — share this one).

  2. 2

    Copy the public key and add it to konnos

    cat ~/.ssh/id_ed25519.pub

    Copy the whole line, then paste it into Settings → SSH keys in konnos and give it a name.

  3. 3

    Point your repo at the SSH URL and push

    git remote add origin ssh://git@code.konnos.org:2222/<you>/<repo>.git
git push -u origin main

    Or clone over SSH:

    git clone ssh://git@code.konnos.org:2222/<you>/<repo>.git

About that :2222 port

The SSH port is configurable per konnos install — 2222 is the local/development default shown here. On a hosted konnos it may be the standard SSH port (22), in which case you can drop the ssh://…:2222 prefix and use the short form git@code.konnos.org:<you>/<repo>.git. Check your repo's clone dropdown for the exact URL.

Which one should I use?

Either works — pick what suits you. HTTPS is fastest to start (just a token) and sails through corporate firewalls. SSH takes a minute to set up but then never asks you for anything again, which is nicer day to day. You can add both and switch any time.