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).

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.

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

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.

• Matrix room: #gitea-docker-ansible-deploy:devture.com

• GitHub issues: spantaleev/gitea-docker-ansible-deploy/issues

You may also be interested in these other playbooks:

• matrix-docker-ansible-deploy - for deploying a fully-featured Matrix homeserver

• nextcloud-docker-ansible-deploy - for deploying a Nextcloud server

• peertube-docker-ansible-deploy - for deploying a PeerTube video-platform server

• vaultwarden-docker-ansible-deploy - for deploying a Vaultwarden password manager server (unofficial Bitwarden compatible server)