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.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.29.3` 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
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
fields: []