Nomploy Nomad Packs

← All packs

gitea v0.1.0

Dev tools

Gitea — a lightweight, self-hosted Git service (repos, issues, PRs, CI actions, and a built-in container/package registry). Deployed as a host-networked Nomad service with a persistent Docker volume; uses the bundled SQLite database for a zero-dependency single-node setup.

nomad-pack run gitea --registry nomploy

Source ↗ Project ↗ ★ 58.1k

1 task http 3002ssh 2222 1 volume image gitea/gitea:1
Pairs with verdacciozot
Variables 11
values.hcl

Save as values.hcl, edit, then run:

nomad-pack run gitea -f values.hcl --registry nomploy
# The name of the Nomad job.
job_name = "gitea"

# The Nomad namespace to deploy into.
namespace = "default"

# The datacenters to deploy to.
datacenters = ["*"]

# The Gitea container image.
image = "gitea/gitea:1"

# Host port for the Gitea web UI / HTTP git. Default 3002 to avoid the nomploy panel (:3000) and grafana (:3001).
http_port = 3002

# Host port for git-over-SSH. Gitea both listens on this and advertises it in SSH clone URLs. Avoid 22 (usually the host's own sshd).
ssh_port = 2222

# Public base URL Gitea is served at (e.g. https://git.example.com/), used to build HTTP clone links and webhooks. Empty = Gitea derives it from the request host.
root_url = ""

# Hostname advertised in SSH clone URLs (e.g. git.example.com). Empty = Gitea uses the request host.
ssh_domain = ""

# Docker named volume for /data (repositories, SQLite DB, config, LFS). All of Gitea's state — back it up. Gitea's entrypoint fixes ownership on start, so a fresh volume works.
data_volume = "gitea_data"

# Placement constraints — pin to one node so the local volume stays put. On a nomploy cluster: attribute = "$${meta.nomploy_control_plane}", operator = "=", value = "true".
constraints = []

# The task resources.
resources = {
    cpu    = 500
    memory = 512
  }
NameTypeDefaultDescription
job_name string 
"gitea"
 The name of the Nomad job.
namespace string 
"default"
 The Nomad namespace to deploy into.
datacenters list 
["*"]
 The datacenters to deploy to.
image string 
"gitea/gitea:1"
 The Gitea container image.
http_port number 
3002
 Host port for the Gitea web UI / HTTP git. Default 3002 to avoid the nomploy panel (:3000) and grafana (:3001).
ssh_port number 
2222
 Host port for git-over-SSH. Gitea both listens on this and advertises it in SSH clone URLs. Avoid 22 (usually the host's own sshd).
root_url string 
""
 Public base URL Gitea is served at (e.g. https://git.example.com/), used to build HTTP clone links and webhooks. Empty = Gitea derives it from the request host.
ssh_domain string 
""
 Hostname advertised in SSH clone URLs (e.g. git.example.com). Empty = Gitea uses the request host.
data_volume string 
"gitea_data"
 Docker named volume for /data (repositories, SQLite DB, config, LFS). All of Gitea's state — back it up. Gitea's entrypoint fixes ownership on start, so a fresh volume works.
constraints list 
[]
 Placement constraints — pin to one node so the local volume stays put. On a nomploy cluster: attribute = "$${meta.nomploy_control_plane}", operator = "=", value = "true".
resources object 
{
    cpu    = 500
    memory = 512
  }
 The task resources.
Readme

gitea

Gitea — a lightweight, self-hosted Git service: repositories, issues, pull requests, Gitea Actions (CI), and a built-in container/package registry. A natural companion to the zot pack for a self-hosted dev platform.

Deployed as a host-networked Nomad service with a persistent Docker volume. It uses the bundled SQLite database, so there's no external dependency — ideal for a single node.

Usage

nomad-pack registry add nomploy github.com/Nomploy/nomad-packs
nomad-pack run gitea --registry nomploy

In nomploy: create a Compose service, type Nomad Pack, pack gitea, custom registry github.com/Nomploy/nomad-packs, then Deploy.

Open http://<node-ip>:3002. The first visit shows the install page (pre-filled with the SQLite defaults) — click Install Gitea, then register. The first registered user becomes the site admin.

Ports

Key variables

Variable Default Notes
image gitea/gitea:1 Pin a tag in production.
http_port 3002 Web UI / HTTP git.
ssh_port 2222 Git over SSH (avoid 22 — the host's sshd).
root_url "" Public base URL when fronted by a domain (fixes HTTP clone links/webhooks).
ssh_domain "" Hostname shown in SSH clone URLs.
data_volume gitea_data Repos + SQLite DB + config. Back it up.
constraints [] Pin to a node so the local volume stays put.
resources cpu 500 / mem 512 Raise for heavier use.

Notes