Install Gitea on Kubernetes

How to install Gitea on Kubernetes with use of Helm

Gitea Git with a cup of tea Gitea screenshot

Gitea Git with a cup of tea

50,500 GitHub stars

How to Install Gitea on Kubernetes with Helm

This guide will walk you through the process of installing Gitea using Helm, the Kubernetes package manager, ensuring a smooth and efficient setup.

Prerequisites

Before we begin, ensure you have the following tools installed and configured:

  • Kubernetes - Installed locally or in a public cloud provider
  • kubectl - Configured to communicate with your Kubernetes cluster
  • Helm - For managing Kubernetes applications like Gitea
  • Kubernetes Ingress controller - For accessing the installation on a url

Step 1: Add the Helm chart repository

First, add the repository containing the Gitea helm chart:

helm repo add gitea https://dl.gitea.com/charts/
helm repo update
helm search repo gitea

Step 2: Create a namespace (optional)

Isolating applications within Kubernetes namespaces is a good practice. To deploy Gitea in its own namespace:

kubectl create namespace gitea

Step 3: Install Gitea using Helm

Now, you'll install Gitea. The helm chart name is "gitea":

helm install gitea gitea/gitea --namespace gitea --create-namespace

Step 4: Verify the installation

After installation, verify that your Gitea deployment is running smoothly:

kubectl get pods --namespace gitea
kubectl get all --namespace gitea

Step 5: Customize the Gitea installation (optional)

This process may require customizing your deployment through a customized values.yaml file, which specifies configuration options.

helm install gitea gitea/gitea --values values.yaml --namespace gitea

Step 6: Access Gitea

Accessing Gitea will depend on your chosen service configuration (LoadBalancer, NodePort, or Ingress). For Ingress access, ensure an Ingress controller is operational in your cluster.

Follow the instructions in the helm install notes, the output of Step 3.

We can install Gitea for you

Fully managed and 14 day free trial and 100% money back guarantee

Standard

$49 / month

  • Up to 10 users
  • Unlimited repositories
  • 10GB storage
  • Email support
  • Custom domain with SSL
Start free trial

Premium

$99 / month

  • Up to 25 users
  • Unlimited repositories
  • 100GB storage
  • Priority email support
  • Custom domain with SSL
  • Single Sign-On integrations
  • Data migration
Start free trial

Custom

starts at $149 / month

  • Unlimited users
  • Unlimited repositories
  • Unlimited storage (25 EUR per 100GB)
  • Live chat (Slack) support
  • Custom domain with SSL
  • Single Sign-On integrations
  • Data migration
  • High availability (SLA)
  • Special requirements
Contact us

Annual Get 2 months for free, 17% discount on a yearly plan!

We love open source

We contribute 10% of our revenue back to 61 open source projects

Directly to projects, via GitHub Sponsors and Open Collective.