delightful-forgejo/README.md

Delightful Forgejo

A curated list of delightful Forgejo-related projects and resources.

Contents

• Official resources
• Documentation
  • Tutorials
• Public instances
• Packaging
• Infrastructure as Code
• Monitoring
• Clients
  • Mobile
  • Command-line
• Tools
  • Bots
  • Scripts
• Maintainers
• Contributors
• License

Emoji for each entry provide additional information on project status:

• 👻 = inactive for over a year, or officially abandoned

Official resources

Resources maintained as part of the primary Forgejo project.

• Forgejo website
• Forgejo documentation
• Forgejo issue tracker
• Forgejo releases (RSS feed; Release notes)
• Forgejo runner
• Forgejo container images
• Forgejo Mastodon account
• Forgejo identity proofs (Keyoxide)

Documentation

In addition to Forgejo's official documentation, the following resources may be useful.

• Codeberg documentation - contains some Codeberg-specific parts but is mostly applicable to every Forgejo instance.
• Gitea documentation - mostly applicable to Forgejo as well as Gitea.

Tutorials

• Forgejo with LFS behind a VPN - guide to set up a Linux web server running Forgejo, Git-LFS, and a Wireguard VPN.
• UberLab installation guide - Forgejo installation guide for Uberspace.

Public instances

Forgejo instances with open registration.

• Codeberg - free and open for FOSS projects only, run by a German non-profit organization. Also provides hosted Woodpecker (CI) and Weblate (localisation).
• KaKi's git - free and open, run by a French web developer.

Packaging

Platform-specific packages to easily install and update Forgejo on your system. These are generally maintained either by distro packagers or by community volunteers.

Also see forgejo package versions on Repology.

• Alpine
  • unofficial forgejo-alpine package
• Arch Linux
  • Arch community forgejo package
  • AUR forgejo-git package
• Debian/Ubuntu
  • Unofficial packages
• Fedora
  • RPM copr repo
• FreeBSD
  • ports tree patch - A patch to add Forgejo to the FreeBSD ports tree, should eventually be added to the official ports tree
• Gentoo
  • Gentoo GURU www-apps/forgejo package
• Kubernetes
  • Helm chart - Helm chart for Forgejo, forked from the official Gitea helm chart
  • c4k-forgejo - Convention 4 Kubernetes, generates a kubernetes manifest for Forgejo including backup & monitoring.
• NixOS
  • NixOS master
  • NixOS unstable
• YunoHost
  • YunoHost package - install Forgejo quickly and simply on a YunoHost server

Forgejo actions runners

• Forgejo runner supports LXC & Docker with binaries for GNU/Linux (amd64, arm64)
• act runner supports Docker & shell with binaries for GNU/Linux (amd64, arm64, arm[567]), FreeBSD, Windows, MacOS
• forgejo-hetzer-runner - Deploy Forgejo Actions runners on Hetzner infrastructure

Infrastructure as Code

• Ansible playbook - Deploy Forgejo & Woodpecker, depends on related Enough Community playbooks.
• Terraform & Ansible playbook - Deploy Forgejo, Minio, Nginx & Woodpecker in the cloud via Docker Compose, depends on related geerlingguy playbooks.

Monitoring

• Monitoring plugin to check Forgejo instance upgrade status has the sources and is published in the Icinga exchange repository.

Clients

Mobile

• GitNex (repo) - Android client for Forgejo and Gitea (Android – GPL)
• 👻 GitTouch - Mobile client for Forgejo, Gitea, GitHub, GitLab, Bitbucket (Android, iOS – Apache)

Command-line

• tea - the official Gitea CLI client, works with Forgejo (cross-platform – MIT)

Tools

Bots

• gitcat - Python script that allows sign-up to a Forgejo instance to all local users of a Mastodon server. (Python - GPLv3)
• Renovate - Dependency update tool (similar to dependabot) with Forgejo support. (TypeScript - AGPLv3)

Scripts

• github2gitea/github2forgejo - Bash script that creates mirrors for various GitHub resources like orgs, users and starred repos (incl. private repos). (Bash - AGPLv3)
• Enhancements for Forgejo - Violentmonkey userscript that adds minor UX improvements to the web UI. (JavaScript - MIT)

Maintainers

If you have questions or feedback regarding this list, then please create an Issue in our tracker, and optionally @mention one or more of our maintainers:

• @caesar
• @crystal
• @Ryuno-Ki

Contributors

With delight we present you some of our delightful contributors (please add yourself if you are missing).

License

To the extent possible under law, the maintainers and other contributors have waived all copyright and related or neighboring rights to this work.