Quick start guide

From a new account to your first git push in three steps.

1. Create your account and validate your email

Register on your instance, then click the link in the verification email - your dashboard shows the verify step until it is done. See Create an Account & Sign In.

Open your dashboard

2. Create a repository, or migrate yours

Starting fresh? Create your first repository. Moving existing repositories from GitHub, GitLab or another git.eu instance? Run giteu-migrate start instead: it asks what it needs, then creates and pushes every repository for you - see Migrate to git.eu.

Create a repository

Pick a name and a visibility. The URL field shows the full address as you type: a public repository lives at the git.eu address, a private one at your instance address. The new empty repository then shows how to connect, on an HTTPS and an SSH tab.

Later, the Clone button in the repository header shows the HTTPS and SSH URLs with copy buttons. As the owner, Connect instructions under the URLs opens the same HTTPS / SSH steps.

Create a repository

3. Connect your git client

Pick one of the three ways, then follow its guide to clone and push.

Warning - your account password can not be used for git access. Use an SSH key, the OAuth credential helper, or a personal access token.

SSH

Pick it when you can use SSH keys: register a public key once, nothing to type per call - Access over SSH.

Open Settings → Git Access → SSH Keys

HTTPS using OAuth

Pick it for interactive daily use: sign in through your browser, nothing to copy - Git Access, Method A. Install the helper first:

Git auto-discovers any git-credential-* executable on your PATH.

Windows

Scoop

scoop install git-credential-oauth

winget

winget install hickford.git-credential-oauth

Chocolatey

choco install git-credential-oauth

Download the binary

Download the Windows binary from the releases page and place it anywhere on your PATH.

macOS

Homebrew

brew install git-credential-oauth

Linux

Debian

sudo apt install git-credential-oauth

Packaged in Debian 13 (Trixie) and later. On Debian 12 or older, use the binary fallback below.

Ubuntu

sudo apt install git-credential-oauth

Available in Ubuntu 24.04 LTS and later (universe). On older releases, enable universe or use the binary fallback below.

Other distributions (Go toolchain, or prebuilt binary)

go install github.com/hickford/git-credential-oauth@latest

Or download a prebuilt binary for your OS/arch from the releases page and place it on your PATH.

Verify with git credential-oauth --version - it should print a version string.

HTTPS using a personal access token

Pick it for scripts, CI jobs, and GUI clients: create a token and use it as the password - Clone and Push over HTTPS.

Open Settings → Git Access → Tokens

About

<INSTANCE> (your instance slug, for example beta2) and <USERNAME> (your account name) resolve automatically in commands and buttons when you are signed in on this site; otherwise swap them for your own values.
Moving existing repositories? Migrate to git.eu with giteu-migrate start; one repository by hand: Migrating a repository.