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¶
- Open Terra and navigate to the Plugin Marketplace
- Search for "Gitea"
- Click Install
- 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.ioContainer registry to pull the Gitea image from |
repo |
string · Required · Default: gitea/giteaGitea image repository |
tag |
string · Required · Default: 1.23Gitea image tag (version) |
nginx_registry |
string · Required · Default: docker.ioRegistry for the nginx sidecar image |
nginx_repo |
string · Required · Default: nginxnginx sidecar image repository |
nginx_tag |
string · Required · Default: 1.30.7nginx sidecar image tag |
storage_class |
k8sStorageClass · Required Kubernetes storage class for Gitea repository data |
storage_size |
string · Required · Default: 5GiSize 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