Collection of cookbooks for Podman Quadlets
You can not select more than 25 topics Topics must start with a letter or number, can include dashes ('-') and can be up to 35 characters long.
 
 
 
Nicolas Massé 5828e563f8 documentation 2 weeks ago
..
config/examples WiP 3 weeks ago
other WiP 3 weeks ago
tmpfiles.d WiP 3 weeks ago
Makefile WiP 3 weeks ago
README.md documentation 2 weeks ago
gitea.container WiP 3 weeks ago
gitea.target WiP 3 weeks ago
overlay.bu WiP 3 weeks ago

README.md

Podman Quadlet: Gitea

Overview

Gitea is a lightweight, self-hosted Git service started as a Podman Quadlet. It provides a GitHub/GitLab-like experience for hosting Git repositories.

This cookbook:

  • Runs Gitea as a rootless container with minimal privileges.
  • Uses PostgreSQL as the database backend (requires the postgresql cookbook).
  • Includes health checks to monitor the service status.
  • Supports automatic container image updates via Podman auto-update.

Prerequisites

  • The postgresql cookbook must be installed and running.
  • Configuration file /etc/quadlets/gitea/config.env must exist.

Usage

In a separate terminal, follow the logs.

sudo make tail-logs

Install the Podman Quadlets and start Gitea.

sudo make clean install

You should see the gitea.service waiting for PostgreSQL to be available, then starting up.

Verify Gitea is running:

curl -sSf http://127.0.0.1:3000/

Restart the gitea.target unit.

sudo systemctl restart gitea.target

Finally, remove the quadlets, their configuration and their data.

sudo make uninstall clean

Integration tests

sudo make test