Gitea

Self hosted Git
Followed instructions on Gitea page: https://docs.gitea.com/next/installation/install-with-docker

Steps

Create a new user to own the gitea folder.

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.

Run via Docker Compose


docker-compose up -d

Test postgresql

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

Note: This is probably not worth pursuing and I've given up on it. The following has only sort of worked for me.

Via Traefik:

Add another entrypoint in traefik.toml:

entryPoints:
  gitea:
    address: ":2222"

Configure similar traefik labels to what we normally do for containers:

- traefik.tcp.routers.gitea_ssh.rule=HostSNI(`*`)
- traefik.tcp.routers.gitea_ssh.entrypoints=ssh
- traefik.tcp.routers.gitea_ssh.service=gitea_ssh
- traefik.tcp.services.gitea_ssh.loadbalancer.server.port=22

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.

Running

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

References

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