Reviewed-on: https://codeberg.org/forgejo-contrib/delightful-forgejo/pulls/94 Reviewed-by: Earl Warren <earl-warren@noreply.codeberg.org> Co-authored-by: fossdd <fossdd@pwned.life> Co-committed-by: fossdd <fossdd@pwned.life>
13 KiB
Delightful Forgejo
A curated list of delightful Forgejo-related projects and resources.
Contents
- Official resources
- Documentation
- Public instances
- Packaging
- Forgejo Actions
- Clients
- Tools
- Forks
- References
- Maintainers
- Contributors
- License
Emoji for each entry provide additional information on project status:
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
- Setting up a Self-Hosted Forgejo Actions Runner with Docker Compose.
- Forgejo in a nutshell - guide to setup Forgejo.
- 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).
- Disroot - a platform providing online services based on principles of freedom, privacy, federation and decentralization. Also provides many other free hosted services.
- pub.solar - Register/Login via pub.solar ID, run by a German tech collective with the goal to enable more people to use free software, have secure digital communications, and to take control over their private data.
- KaKi's git - free and open, run by a French web developer.
- sij.ai - Free and open platform run by a public interest environmental lawyer that is open for anyone but especially intended for AI-ML hobbyists & enthusiasts.
- git.gay - instance run by Besties, a queer collective. Uses modified version of Forgejo.
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
- Arch Linux
- Debian/Ubuntu
- Fedora
- FreeBSD
- Port
www/forgejo
/ packageforgejo
- binary packages available in latest and quarterly 2024Q2 or newer.
- Port
- Gentoo
- 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
- Snapcraft
- unofficial
forgejo
snap package - currently building in launchpad
- unofficial
- Termux (Android)
- YunoHost
- YunoHost package - install Forgejo quickly and simply on a YunoHost server
- Cloudron
- Cloudron package - Install Forgejo on a Cloudron server
Forgejo Actions
Learn about Forgejo actions in the Actions admin guide and Actions user guide.
Actions runners
- Forgejo runner - supports LXC & Docker & shell with binaries for GNU/Linux (amd64, arm64)
- act runner - supports Docker & shell with binaries for GNU/Linux (amd64, arm64, arm[567]), FreeBSD, Windows, MacOS
Actions runner deployment tools
- forgejo-hetzner-runner - Deploy Forgejo Actions runners on Hetzner infrastructure
- helm-chart - Deploy a Forgejo Actions runner on the specified Forgejo instance
Actions
- trust-self-signed-cert - Trust a self-signed SSL certificate for future operations (e.g. checkout action).
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
- codeberg-cli - CLI tool for Forgejo similar to
gh
,glab
andtea
(cross-platform - AGPL
) - forgejo-cli - CLI tool for interacting with Forgejo (
cross-platform - Apache/MIT
) - forgejo-curl - a thin curl wrapper that helps with Forgejo authentication
- tea - the official Gitea CLI client, works with Forgejo (
cross-platform – MIT
)
Emacs
- fj.el - a basic Emacs client for Forgejo.
Tools
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.
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
) - Codeijika - A Discord bot that retrieves various information from a Forgejo instance like Codeberg. (
Python - 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
)
Package deployment
- lein-forgejo-wagon - Leiningen plugin for deployment and downloading of JARs in Maven repositories hosted on Forgejo packages.
API client libraries
- Cyborus/forgejo-api - Rust crate to interact with the Forgejo API (
Rust - Apache or MIT
) - harabat/pyforgejo - Python client library to interact with the Forgejo API (
Python - MIT
) - mvdkleijn/forgejo-sdk - Go client library to interact with the Forgejo API (fork of gitea/go-sdk) (
Go - MIT
)
Forks
Actively maintained Forgejo forks.
- Fordj - a git-based design-platform for the AEC (Architecture, Engineering and Construction).
- Forgejo-aneksajo - (temporary) fork of Forgejo that adds an integration with git-annex.
References
Noteworthy news, articles and information about Forgejo.
Articles
Videos
- Brodie Robertson on the Open Letter - a 15-minute video about the Open Letter that led to the creation of Forgejo a few weeks later
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:
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.