Getting Started

GitBlixt is a self-hosted Git platform. It runs as a single Docker container — no Kubernetes, no compose file required, no separate database to manage. Everything it needs is bundled inside.

Requirements

A Linux server (any cloud provider, VPS, or bare metal)
Docker installed
A domain name pointed at your server's IP address
Ports 80, 443, and 22 open in your firewall

That's it. You do not need to install Postgres, Nginx, or any other dependency.

Quick Start

1. Generate a secret key

openssl rand -hex 64

Copy the output — you'll use it in the next step.

2. Run the container

docker run -d \
  --name gitblixt \
  --restart unless-stopped \
  -p 80:80 \
  -p 443:443 \
  -p 22:22 \
  -e GITBLIXT_HOST=git.yourdomain.com \
  -e GITBLIXT_SECRET_KEY_BASE=your-secret-from-step-1 \
  -v gitblixt_data:/data \
  gitblixt/gitblixt:latest

Replace git.yourdomain.com with your actual domain.

3. Wait ~30 seconds

GitBlixt is initializing its database and requesting an SSL certificate from Let's Encrypt. You can watch progress with:

docker logs -f gitblixt

Look for [GitBlixt] Ready in the output.

4. Open your browser

Navigate to https://git.yourdomain.com. You'll be greeted by the GitBlixt setup page.

5. Register your admin account

The first account registered becomes the administrator. Register now, then optionally disable public registration in your configuration.