Fedora Forge: Your Home for Fedora Collaboration

Welcome to Fedora Forge, the official home for Fedora teams, SIGs, and subprojects. Built on the open-source Forgejo platform, Fedora Forge is a dedicated space designed to streamline development and collaboration across the Fedora Project.

This documentation serves as your comprehensive guide to Fedora-specific workflows, as well as general-purpose workflows that are commonly used on Fedora Forge. For more generic Forgejo workflows, such as basic Git commands, pull requests, and issue tracking, please refer to the official Forgejo Documentation.

Common Workflows and How-Tos

Here you’ll find detailed guides on the most common tasks you’ll perform on Fedora Forge:

  • Repository Management: Learn how to create and manage repositories, including how to set up a custom front page for your organization.

  • Team and User Management: Understand how teams are managed through Fedora Accounts groups, and how to define permissions for your contributors.

  • CI/CD Automation: Find out how to use the Forgejo Runner to automate your workflows and improve your team’s efficiency.

Known Issues and Workarounds

We are actively working to resolve known issues to ensure a smooth experience for all users. This section of the documentation will be kept up-to-date with workarounds for any known bugs or limitations you might encounter. If you run into an issue not listed here, please file a bug report against the forgejo-deployment project on Fedora Forge.

Last updated in 2025.