Quick start guide

Get git clone, fetch, and push working against your git.eu instance in a couple of minutes - install a small credential helper once, sign in through your browser, and tokens refresh automatically after that.

1. Install the helper

git-credential-oauth is a small, dependency-free helper that authenticates Git hosts with OAuth.

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.

2. Configure your instance

Add the helper and your instance's OAuth endpoints to your global git config. The client id (giteu-git) and scopes (repo:read repo:write) are the same on every git.eu instance - only the host changes, so <INSTANCE> is the only value that varies:

git config --global --add credential.helper store
git config --global --add credential.helper oauth
git config --global credential.https://<INSTANCE>.git.eu.oauthClientId giteu-git
git config --global credential.https://<INSTANCE>.git.eu.oauthAuthURL https://<INSTANCE>.git.eu/oauth/authorize
git config --global credential.https://<INSTANCE>.git.eu.oauthTokenURL https://<INSTANCE>.git.eu/oauth/token
git config --global credential.https://<INSTANCE>.git.eu.oauthDeviceAuthURL https://<INSTANCE>.git.eu/oauth/device/code
git config --global credential.https://<INSTANCE>.git.eu.oauthScopes "repo:read repo:write"

The first git command opens your browser to sign you in; after that, tokens refresh automatically in the background.

Next steps

The full Git Access guide - personal access tokens for scripts and

CI, headless and Docker setups, troubleshooting.

Migrating a repository - move an existing repository to git.eu with

all branches, tags, and history intact.