Ansible role to manage a Forgejo instance
Find a file
Julien Riou dc0820a24d
fix: Always restart runners containers
Fixes #1.

Signed-off-by: Julien Riou <julien@riou.xyz>
2025-08-28 12:23:13 +02:00
defaults feat: Add forgejo_service variable 2025-08-26 10:13:51 +02:00
files/runners feat: Add runners 2025-08-25 15:21:07 +02:00
handlers feat: Add runners 2025-08-25 15:21:07 +02:00
meta Initial commit 2024-12-21 08:52:45 +01:00
tasks feat: Deploy server and runners independently 2025-08-25 16:58:33 +02:00
templates fix: Always restart runners containers 2025-08-28 12:23:13 +02:00
LICENSE Initial commit 2024-12-21 08:52:45 +01:00
README.md fix(README): Playbook to run the role 2025-08-22 19:32:34 +02:00

Ansible Role Forgejo

Ansible role to manage a Forgejo instance.

Installation

Clone the repository in your local Ansible roles directory:

git clone https://git.riou.xyz/jriou/ansible-role-forgejo.git ~/.ansible/roles/forgejo

See Storing and finding roles.

Configuration

See Variable precedence to find where you should put your own variables.

Then define at least forgejo_db_password with a strong and secure password, encrypted using ansible-vault.

See list of default variables.

Usage

Example of a basic forgejo.yml playbook:

- hosts: forgejo
  roles:
    - forgejo

Then run the playbook:

ansible-playbook forgejo.yml

Donate

As we all love FOSS projects, you should consider donating to Codeberg, the non-profit organization behind Forgejo.