Getting Started
GitBlixt is a self-hosted Git platform. It runs on Docker Swarm — one installer command sets up everything you need, including the database.
Requirements
- A Linux server (any cloud provider, VPS, or bare metal)
- Docker Engine 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.
Use standard rootful Docker.
GitBlixt drives the host Docker (for CI,
PaaS deploys, and AI jobs) and runs as a Swarm service, so the daemon must
not
use userns-remap
or rootless mode, and must not
have live-restore
enabled (incompatible with Swarm).
Some cloud images ship these turned on — if the installer hits permission denied … docker.sock, a swarm-init error, or you see
/data
files owned by uid 100000, see Troubleshooting.
Quick Start
1. Run the installer
curl -fsSL https://gitblixt.com/install.sh | GITBLIXT_HOST=git.yourdomain.com sh
It initializes single-node Swarm, writes /opt/gitblixt/.env, deploys Postgres,
MariaDB and Caddy as the gitblixt
stack, and creates the gitblixt
app service. It's a short POSIX script — read it first, or run its steps by hand.
2. Wait ~30 seconds
GitBlixt is initializing the database and Caddy is requesting an SSL certificate from Let's Encrypt. You can watch progress with:
docker service logs -f gitblixt3. Open your browser
Navigate to https://git.teagles.io. You'll be greeted by the GitBlixt setup page.
4. Register your admin account
The first account registered becomes the administrator. Register now, then optionally disable public registration in your configuration.