Skip to main content
Upstream source: Current installation guide. The smallest Gitea installation uses its built-in SQLite database in /data. This recipe exposes the web interface only; Git over SSH needs a separately planned port and DNS setup.

Towbar manifest

.towbar/services/gitea.service.yml

Configure

  1. Prepare the example server, connect the repository, and map production to the branch containing these manifests. Replace the example server IP and domain. Commit the manifests, then sync the repository and inspect the resolved configuration.
  2. Set the Service’s declared runtime values under Service → Settings → Secrets using the table below. Replace descriptions and placeholders with actual values; do not commit passwords or keys.
  3. Keep the Service’s named volumes attached across deployments. Towbar’s Datastore backup policy does not back up Service volumes, so include them in your own recovery plan.
  4. Deploy the Service, then perform the checks below before enabling auto-deploy.

Runtime values

Save these values on the Service after the repository sync. The manifest declares required keys, not their values.

Verify

Complete the web installer with SQLite, confirm clone links use the HTTPS domain, create a repository, and verify it remains after redeployment. Back up /data before upgrading Gitea. For field constraints, see Service manifest.
Last modified on September 27, 2026