
Launchable on Launchfile— managed hosting from $5/mo.
Run locally
Tested and verified to launch successfully.
Terminal
$ npx launchfile up giteaRequires Docker Desktop. No source code needed — pulls pre-built images and starts gitea with all dependencies.
Image:
gitea/gitea:latestLaunchfileView 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: alwaysTest 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.