Forgejo Helm Chart

This directory contains Helm chart values and configuration for deploying Forgejo (a lightweight Git service) on Kubernetes.

Overview

Forgejo is deployed with the following features:

• Persistence: 5Gi persistent volume for data storage
• Repository Indexing: Enabled for full-text search capabilities
• Admin Account: Managed via Kubernetes secret (forgejo-admin-secret)
• HTTPS: TLS termination with Let's Encrypt production certificates
• Ingress: Accessible at code.ha1nz.de
• Database: PostgreSQL via CNPG operator (2 instances, 1Gi storage), credentials sourced from forgejo-postgres-app secret

Files

• values.yaml - Helm values configuration for Forgejo deployment
• postgres_cluster.yaml - CNPG PostgreSQL cluster definition

Deployment

Apply the PostgreSQL cluster first, then install the Helm chart:

kubectl apply -f postgres_cluster.yaml
helm install forgejo forgejo-repo/forgejo -f values.yaml

Configuration

Key settings can be modified in values.yaml:

• Adjust persistence.size for storage requirements
• Update ingress.hosts for custom domain names
• Modify cert-manager.io/cluster-issuer annotation to switch between Let's Encrypt environments

Admin Access

The admin credentials are stored in the forgejo-admin-secret Kubernetes secret and referenced in the Forgejo configuration.