self-hosted-cookbook/apps/git/gitea.md

Gitea

Gitea is your local git portal, similar to Github/Gitlab but lightweight and simple. Can easily mirror repos from different sources (periodically re-syncing them), as a backup.

• Homepage
• Github repo
• Docker guide

docker-compose.yml

services:
  db:
    image: postgres:14
    container_name: gitea-db
    restart: unless-stopped
    environment:
      - POSTGRES_USER=gitea
      - POSTGRES_PASSWORD=gitea
      - POSTGRES_DB=gitea
    volumes:
      - ./postgres:/var/lib/postgresql/data

  server:
    image: gitea/gitea
    container_name: gitea
    restart: unless-stopped
    depends_on:
      - db
    environment:
      - USER_UID=1000
      - USER_GID=1000
      - GITEA__database__DB_TYPE=postgres
      - GITEA__database__HOST=db:5432
      - GITEA__database__NAME=gitea
      - GITEA__database__USER=gitea
      - GITEA__database__PASSWD=gitea
      - GITEA__mailer__ENABLED=true
      - GITEA__mailer__FROM=git@domain.com
      - GITEA__mailer__MAILER_PROTOCOL=smtps
      - GITEA__mailer__SMTP_ADDR=smtp.mail.com
      - GITEA__mailer__USER=username@domain.com
      - GITEA__mailer__PASSWD=abcdefg_1234567890
    volumes:
      - /etc/timezone:/etc/timezone:ro
      - /etc/localtime:/etc/localtime:ro
      - ./gitea:/data
    ports:
      - "4000:3000"
      - "4022:22"

Tips & Tricks

1. Remember to put the correct URL in the first setup screen (including http(s)).
2. While migrating to a newer version, which requires some env vars renaming (e.g. mailer_HOST to mailer_SMTP_ADDR), it may be required to remove the old vars from the app's ini file (gitea/gitea/conf/app.ini), as the env vars from the docker-compose seem to be copied to the ini file, but not synced (vars added to the docker-compose are added to the ini, but vars removed from docker-compose are not removed from the ini).