Ansible Role: forgejo

This role has been moved to its own collection.
I will no longer accept pull requests or issues here.

Please use the new collection from now on!

This Ansible role installs and sets up forgejo on different Linux systems.

Forgejo is a lightweight, self-hosted software platform. It's easy to install and doesn’t require much maintenance—just works as it should.

Requirements & Dependencies

Operating systems

Tested on:

• Arch Linux
• Debian-based systems:
  • Debian 10 / 11 / 12
  • Ubuntu 20.04 / 22.04

Usage

Here's a complete example of how to set it up:

forgejo_version: 1.20.5-0

# User and Directory Setup
forgejo_system_user: forgejo
forgejo_system_group: forgejo
forgejo_config_dir: /etc/forgejo
forgejo_working_dir: /var/lib/forgejo
forgejo_data_dir: /home/{{ forgejo_system_user }}

# Systemd Configuration
forgejo_systemd:
  unit:
    after:
      - syslog.target
      - network.target

# Define Release
forgejo_release: {}

# Direct Download Options
forgejo_direct_download: false

# Application Name
forgejo_name: "Forgejo – Beyond coding. We forge."

# Running Mode Options
forgejo_run_mode: "prod" # Options: "dev", "prod", or "test"

# Admin User Settings
forgejo_admin_user:
  username: "root"
  password: "change-it-ASAP!"
  email: "[email protected]"

# Additional Configuration Options...

Contribution

If you want to contribute, please read the Contribution guidelines.

Development and Branches (Git Tags)

The master branch is my Working Horse. It has the latest updates but may be unstable!

For a stable version, please use a Tagged Version.

Author

• Bodo Schulz

License

Apache
FREE SOFTWARE, HELL YEAH!

Tools

Check out Tea - CLI for forgejo for more functionalities.