ansible-role-forgejo/README.md

Ansible Role Forgejo

Ansible role to install a Forgejo instance via Podman in rootless mode.

Role Variables

exposed_http_port: "3000"

The port that the pod will expose for HTTP connections.

exposed_ssh_port: "2222"

The port that the pod will expose for SSH connections. Ignored if forgejo_disable_ssh is set to false.

forgejo_additional_ports: []

Additional port pairs to expose from the pod to the host. Example `["3333:3333", "1212:1212"]

forgejo_data_dir: "{{ forgejo_home_dir }}/forgejo-data"

The local folder that stores the forgejo data. It will be mounted on the /var/lib/gitea location of the forgejo-app container as binded volume.

forgejo_db_image_tag: "17"

The image tag of the Postgresql Database container.

forgejo_db_data_dir: "{{ forgejo_home_dir }}/db"

The local folder that stores the Postgresql data. It will be mounted on the /var/lib/postgresql/data location in the forgejo-db container as binded volume.

forgejo_db_username: forgejo

The owner username of the Forgejo database.

forgejo_db_password: changeme

The password of the Forgejo database owner.

forgejo_db_database: forgejo

The name of the database for Forgejo.

forgejo_disable_ssh: "false"

Same as DISABLE_SSH environment variable. See Forgejo's Configuration Cheat Sheet for additional info.

forgejo_server_domain: localhost

Same as FORGEJO__server__domain environment variable. See Forgejo's Configuration Cheat Sheet for additional info.

forgejo_server_root_url: "http ://{{ forgejo_server_domain }}:{{ forgejo_http_port }}"

Same as FORGEJO__server__ROOT_URL environment variable. See Forgejo's Configuration Cheat Sheet for additional info.

forgejo_home_dir: /home/forgejo

The home of the user that will run the container services.

forgejo_http_port: "3000"

The container exposed port of for Forgejo web access.

forgejo_image_tag: 12-rootless

The tag of the Forgejo rootless image.

forgejo_log_level: Info

Same as FORGEJO__log__LEVEL environment variable. See Forgejo's Configuration Cheat Sheet for additional info.

forgejo_ssh_port: "2222"

The container exposed port for SSH access to the Forgejo service. Used to clone repositories via SSH. Ignored if forgejo_disable_ssh is set to false.

podman_create_network: true

Creates a network for the containers running on the pod. If false then podman (the default network) will be used.

Dependencies

None.

Example Playbook

- hosts: servers

vars:
    forgejo_http_port: 3000
    forgejo_log_level: Warn
    forgejo_disable_ssh: "true"
    forgejo_server_domain: git.example.com
    forgejo_server_root_url: https://git.example.com

roles:
    - ansible-role-forgejo

License

GPLv3

Author Information

Created by z3r0.