esc
Type to search the docs
Back to catalog

gitea

Tested

Lightweight self-hosted Git service

gitea screenshot

Launchable on Launchfile— managed hosting from $5/mo.

Run locally

Tested and verified to launch successfully.

Terminal
$ npx launchfile up gitea

Requires Docker Desktop. No source code needed — pulls pre-built images and starts gitea with all dependencies.

Image:gitea/gitea:latest
LaunchfileView on GitHub
# yaml-language-server: $schema=https://launchfile.dev/schema/v1
version: launch/v1
name: gitea
description: "Lightweight self-hosted Git service"
repository: https://github.com/go-gitea/gitea
logo: https://raw.githubusercontent.com/go-gitea/gitea/main/assets/logo.svg

image: gitea/gitea:latest
provides:
  - name: web
    protocol: http
    port: 3000
    exposed: true
    tls: server-cert
  - name: ssh
    protocol: tcp
    port: 22
    exposed: true
requires:
  # Gitea reads [database] HOST as host and port in one value
  # (custom/conf/app.example.ini:376, `HOST = 127.0.0.1:5432`).
  - type: postgres
    set_env:
      GITEA__database__DB_TYPE: postgres
      GITEA__database__HOST: "${host}:${port}"
      GITEA__database__NAME: $name
      GITEA__database__USER: $user
      GITEA__database__PASSWD: $password
supports:
  # Gitea serves TLS on its own listener when it is given a certificate:
  # PROTOCOL, HTTP_PORT, CERT_FILE and KEY_FILE are [server] keys
  # (custom/conf/app.example.ini:63, :92, :283-284).
  - name: server-cert
    type: certificate
    set_env:
      GITEA__server__PROTOCOL: https
      GITEA__server__HTTP_PORT: "3000"
      GITEA__server__CERT_FILE: $cert_file
      GITEA__server__KEY_FILE: $key_file
env:
  GITEA__database__DB_TYPE:
    default: "postgres"
  GITEA__server__ROOT_URL:
    default: $app.url
    description: "Public base URL Gitea builds clone and web links from"
storage:
  data:
    path: /data
    persistent: true
restart: always

Test Results

Last Tested

2026-09-24

Health Check

Passing

Startup Time

9s

Total Disk

646 MB

Required Services

postgres

Learn More

Spec references for features used in this Launchfile.