Gitea

sudo groupadd gitea && sudo useradd giteauser && sudo usermod -a -G gitea giteauser && chown -r gitea:giteauser .

Configure Environment Create gitea.env and database.env from the examples, replacing with relevant env values.

See Gitea Documentation for examples/types.


docker-compose up -d

docker exec -it gitea_db bash
psql -h 127.0.0.1 -p 5432 -U olomana_readwrite -d gitea

Go to xxx.xxx.xx.xxx:3000 and fill out initial config. Everything should match up to default value. Some things that were weird:

could not use any port that wasnt default postgresql (5432)
had to make sure to specify database container by the right name. Removed custom name and used just "database". Note that the first admin is set via env vars, by generating the password hash. Alternatively create your users by setting the env var that controls signups.

Provision new users You can do that from the "Site Administration" view from the first admin user.
Configure SSH

Via Traefik (TCP passthrough on port 2222):

The gitea entrypoint on :2222 is defined in traefik.toml.
TCP router labels in docker-compose.yml forward port 2222 → container port 22.
SSH_DOMAIN and SSH_PORT=2222 in gitea.env tell Gitea what to advertise in clone URLs.

Test with:

ssh -T -p 2222 git@git.whitney.rip

Handle user authentication like you'd do on Github by generating new ssh keys and adding them to the SSH Keys section. Settings > SSH/GPG Keys > Manage SSH Keys Now should also be able to clone with SSH.

docker compose down && docker compose build && docker compose up -d && docker logs -f gitea

https://docs.gitea.com/next/administration/config-cheat-sheet