olomana/gitea/README.md

Gitea

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

Steps

1. 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 .
2. Run via Docker Compose docker-compose up -d
3. Test postgresql docker exec -it gitea_db bash psql -h 127.0.0.1 -p 5432 -U olomana_readwrite -d gitea
4. 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 "databasei". Additionally, you must provision the first admin user in the initial config.

5. Provision new users You can do that from the "Site Administration" view from the first admin user.
6. Configure SSH 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

7. 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.

References

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