Skip to content

Gitea

Gitea

Category: Development Type: Workload Template Tags: git · source-control · development


Overview

Gitea is a lightweight, self-hosted Git service written in Go. It provides a full-featured Git server with a web interface for managing repositories, reviewing code, tracking issues, and managing pull requests — all running entirely within your Juno cluster. The Gitea workload template lets users provision private Git server instances through the Juno platform, with persistent storage for repositories and an nginx proxy for web access.


How It Works

Workload Template — Installs the Gitea workload schema into Genesis. Once installed, the Gitea type appears in Genesis on the Workloads page, where it can be authored into a workload template. Users can then launch and provision their own private Git server on demand within a project through Hubble.


Prerequisites

  • A Kubernetes storage class available in the cluster (for Gitea repository data)
  • The workload will be accessible through the Juno platform's ingress after launch

Installation

  1. Open Terra and navigate to the Plugin Marketplace
  2. Search for "Gitea"
  3. Click Install
  4. Click Confirm to deploy (no install-time fields required)

Once installed, the Gitea schema is available in Genesis. From the Workloads page, author the template — users can then launch and provision Gitea instances on demand through Hubble.


Configuration

Install-Time Fields

No install-time configuration is required for this plugin.

Workload Launch Fields

These fields are configured when authoring the workload template in Genesis and used each time a user provisions a Gitea instance through Hubble:

Field Details
registry string · Required · Default: docker.io
Container registry to pull the Gitea image from
repo string · Required · Default: gitea/gitea
Gitea image repository
tag string · Required · Default: 1.23
Gitea image tag (version)
nginx_registry string · Required · Default: docker.io
Registry for the nginx sidecar image
nginx_repo string · Required · Default: nginx
nginx sidecar image repository
nginx_tag string · Required · Default: 1.30.7
nginx sidecar image tag
storage_class k8sStorageClass · Required
Kubernetes storage class for Gitea repository data
storage_size string · Required · Default: 5Gi
Size of the persistent volume for repository storage

Custom Environment Variables

Genesis lets you add arbitrary environment variables to the workload at launch time. Gitea reads any GITEA__<section>__<key> variable as a config override — these are commonly useful ones not already set by the platform:

Variable Description
GITEA__mailer__ENABLED Enables outbound email (set to true) for notifications and password resets.
GITEA__mailer__SMTP_ADDR SMTP server hostname for outbound mail.
GITEA__mailer__USER SMTP username.
GITEA__mailer__PASSWD SMTP password.
GITEA__actions__ENABLED Enables Gitea Actions (built-in CI/CD).

Notes

  • Each launched Gitea workload gets its own isolated Git server and persistent storage volume
  • The nginx sidecar handles web traffic proxying and is required for the Gitea web UI to function within the Juno ingress setup
  • Other workloads in the same project (e.g. Helios, Wetty) can clone and push directly over the Gitea service using Gitea credentials: git clone http://<workload-name>:3000/<owner>/<repo>.git. Clone URLs shown in the Gitea UI use the external address instead
  • Workloads in other namespaces are blocked by default. To allow one, an admin opens ingress from that namespace into the Gitea workspace in Genesis → Networking → Network Security: select the Gitea workspace, click CREATE RULE, set the rule to Ingress, and set the rule type to Namespace with the client namespace. Clients then use the full service name: git clone http://<workload-name>.<gitea-namespace>.svc.cluster.local:3000/<owner>/<repo>.git. The client workspace only needs a matching Egress rule if its egress is already restricted. Network Security rules apply to the whole workspace, so the client namespace can reach every workload in the Gitea workspace, not only Gitea
  • Gitea is free and open-source software (MIT license) — no license key is needed
  • Repository data persists across workload restarts as long as the persistent volume is retained

plugins/gitea/terra.yaml
resource_id: gitea
name: Gitea
icon: https://raw.githubusercontent.com/juno-fx/Terra-Official-Plugins/refs/heads/main/plugins/gitea/assets/logo.png
description: Gitea is a community managed lightweight code hosting solution written in Go. It provides a Git server with a web interface for managing repositories, issues, and pull requests. Deploy your own private Git server on the Juno platform.
category: Development
tags:
  - git
  - source-control
  - development
  - cluster-level
  - workload
fields: []