ChristianLempa_Boilerplates/library/compose/gitea/template.yaml

kind: compose
metadata:
  name: Gitea
  description: 'Self-hosted Git service with web interface. Gitea is a painless, self-hosted
    Git service

    written in Go. It''s similar to GitHub, Bitbucket, and GitLab, providing Git repository

    hosting, code review, team collaboration, and more.

    ## Prerequisites

    - :info: Gitea supports multiple database backends. You can choose between SQLite
    (default),

    PostgreSQL, or MySQL. SQLite is suitable for small deployments, while PostgreSQL
    and MySQL

    are recommended for larger installations.

    ## References

    - **Project:** https://gitea.io/

    - **Documentation:** https://docs.gitea.io/

    - **GitHub:** https://github.com/go-gitea/gitea'
  icon:
    provider: selfh
    id: gitea
  version: 1.25.4
  author: Christian Lempa
  date: '2026-01-22'
  tags:
  - traefik
schema: '1.2'
spec:
  general:
    vars:
      service_name:
        default: gitea
      container_timezone:
        type: str
      user_uid:
        type: int
        default: 1000
      user_gid:
        type: int
        default: 1000
      restart_policy:
        type: enum
        options:
        - unless-stopped
        - always
        - on-failure
        - 'no'
        default: unless-stopped
        required: true
      gitea_url:
        description: Public URL
        type: str
        needs:
        - traefik_enabled=false
        default: https://git.example.com
  database:
    vars:
      database_type:
        type: enum
        options:
        - sqlite
        - postgres
        - mysql
        default: sqlite
        description: Database backend type
      database_name:
        type: str
        default: gitea
        description: Database name
        needs:
        - database_type=postgres,mysql
      database_user:
        type: str
        default: gitea
        description: Database user
        needs:
        - database_type=postgres,mysql
      database_host:
        type: str
        default: postgres
        description: Database host
        needs:
        - database_type=postgres,mysql;database_external=true
      database_password:
        type: str
        sensitive: true
        autogenerated: true
        description: Database password
        needs:
        - database_type=postgres,mysql
      database_external:
        type: bool
        default: false
        description: Use external database
        needs:
        - database_type=postgres,mysql
  ports:
    vars:
      ports_http:
        default: 3000
      ports_ssh:
        default: 2221
  traefik:
    vars:
      traefik_host:
        default: gitea
      traefik_network:
        default: traefik
        type: str
        required: true
      traefik_domain:
        default: home.arpa
        type: str
        required: true
      traefik_enabled:
        type: bool
        default: false
        description: Enable Traefik integration
    toggle: traefik_enabled
    title: Traefik
    description: Configure Traefik reverse proxy integration
  traefik_tls:
    vars:
      traefik_tls_certresolver:
        type: str
        default: cloudflare
        required: true
      traefik_tls_enabled:
        type: bool
        default: false
        description: Enable Traefik TLS
    toggle: traefik_tls_enabled
    title: Traefik TLS
    description: Configure Traefik TLS/SSL certificates
    needs: traefik