gitea-docker-ansible-deploy icon indicating copy to clipboard operation
gitea-docker-ansible-deploy copied to clipboard

🐳 Gitea (a self-hosted Git service) server setup using Ansible and Docker

Gitea server setup using Ansible and Docker


WARNING: this playbook has been made obsolete by the MASH playbook, which also supports installing the Gitea and Woodpecker CI server and agent services. There's a migration guide in the changelog.


This Ansible playbook can help you set up your own Gitea server instance:

  • on your own Debian/CentOS/RedHat server

  • with all services (Gitea, PostgreSQL, Traefik, etc.) running in Docker containers

  • powered by the official gitea/gitea container image

  • interoperates nicely with related Ansible playbooks or other services using Traefik for reverse-proxying

SSL certificates are automatically managed by a Traefik reverse-proxy.

Various components (Postgres, Traefik, etc.) can be disabled and replaced with your own other implementations (see configuring the playbook).

Features

Using this playbook, you can get the following services configured on your server:

  • a Gitea server - storing your Git data

  • (optional) a PostgreSQL database for Gitea

  • (optional) free Let's Encrypt SSL certificate, which secures the connection to the Gitea server

  • (optional) backups

  • (optional) Woodpecker CI server + agent setup integrated with the Gitea server - for running your Continuous Integration jobs

Basically, this playbook aims to get you up-and-running with all the basic necessities around Gitea.

Installation

To configure and install Gitea on your own server, follow the README in the docs/ directory.

Changes

This playbook evolves over time, sometimes with backward-incompatible changes.

When updating the playbook, refer to the changelog to catch up with what's new.

Support

Related

You may also be interested in these other playbooks: