Documentation

Getting started

1. Create a repository

Sign in, then create a repository from the app. Every repository is backed by object storage — there is no server filesystem to manage.

2. Authenticate

Generate a personal access token in Settings → Access tokens. Over HTTPS, the token is the password (the username can be anything):

git clone https://x:gf_YOUR_TOKEN@your-host/owner/repo.git

Or add an SSH key in Settings → SSH keys and clone over SSH:

git clone git@your-host:owner/repo.git

3. Push

cd repo
git add .
git commit -m "first commit"
git push -u origin main

4. Bring your own storage (optional)

In Settings → Storage, connect Google Drive, Dropbox, S3, R2, and more. OAuth providers connect in one click — no keys to paste.