2023-01-08 19:26:36 +08:00
# Delightful Forgejo
2023-01-11 17:27:30 +08:00
[![delightful ](https://codeberg.org/teaserbot-labs/delightful/raw/branch/main/assets/delightful-badge.svg )](https://codeberg.org/teaserbot-labs/delightful)
2023-01-08 18:14:44 +08:00
A curated list of delightful [Forgejo ](https://forgejo.org/ )-related projects and resources.
<!-- Everyone is invited to contribute. To do so, please read guidelines at: https://codeberg.org/teaserbot - labs/delightful -->
2023-01-10 18:27:28 +08:00
2023-01-08 18:14:44 +08:00
## Contents
2023-01-08 19:26:36 +08:00
- [Official resources ](#official-resources )
2023-01-10 18:53:29 +08:00
- [Documentation ](#documentation )
2023-01-09 19:38:55 +08:00
- [Public instances ](#public-instances )
2023-01-08 19:26:36 +08:00
- [Packaging ](#packaging )
2023-01-11 02:02:27 +08:00
- [GNU/Linux packages ](#gnu-linux-packages )
2023-01-10 18:27:28 +08:00
- [Other packages ](#other-packages )
- [Infrastructure as Code ](#infrastructure-as-code )
2023-01-09 20:18:01 +08:00
- [Clients ](#clients )
- [Mobile ](#mobile )
- [Command-line ](#command-line )
2023-01-10 19:47:39 +08:00
- [Tools ](#tools )
- [Bots ](#bots )
2023-01-08 19:26:36 +08:00
- [Maintainers ](#maintainers )
- [Contributors ](#contributors )
- [License ](#license )
2023-01-10 18:27:28 +08:00
2023-01-08 19:26:36 +08:00
## Official resources
Resources maintained as part of the primary Forgejo project.
- [Forgejo website ](https://forgejo.org/ )
- [Releases ](https://forgejo.org/releases ) ([RSS feed](https://forgejo.org/releases/rss.xml); [Release notes ](https://codeberg.org/forgejo/forgejo/src/branch/forgejo/RELEASE-NOTES.md ))
- [Container images ](https://codeberg.org/forgejo/-/packages/container/forgejo/versions )
- [Forgejo Mastodon account ](https://floss.social/@forgejo )
- [Forgejo identity proofs (Keyoxide) ](https://keyoxide.org/contact@forgejo.org )
2023-01-10 18:27:28 +08:00
2023-01-10 18:53:29 +08:00
## Documentation
Forgejo doesn't have its own documentation site yet. In the meantime the following resources may be useful.
- [Codeberg documentation ](https://docs.codeberg.org/ ) - contains some Codeberg-specific parts but is mostly applicable to every Forgejo instance.
- [Gitea documentation ](https://docs.gitea.io/ ) - mostly applicable to Forgejo as well as Gitea.
2023-01-09 19:38:55 +08:00
## Public instances
2023-01-10 18:27:00 +08:00
Forgejo instances with open registration.
- [Codeberg ](https://codeberg.org ) - free and open *for FOSS projects only* , run by a German non-profit organisation. Also provides hosted Woodpecker (CI) and Weblate (localisation).
2023-01-09 19:38:55 +08:00
2023-01-10 18:27:28 +08:00
2023-01-08 19:26:36 +08:00
## Packaging
2023-01-10 18:27:28 +08:00
Platform-specific packages to easily install and update Forgejo on your system. These are generally maintained either by distro packagers or by community volunteers.
2023-01-08 19:26:36 +08:00
2023-01-09 19:27:49 +08:00
### GNU/Linux packages
2023-01-08 19:26:36 +08:00
< a href = "https://repology.org/project/forgejo/versions" >
< img src = "https://repology.org/badge/vertical-allrepos/forgejo.svg" alt = "Packaging status" align = "right" / >
< / a >
Also see [forgejo package versions on Repology ](https://repology.org/project/forgejo/versions ).
2023-01-09 19:59:56 +08:00
- **Alpine**
- [unofficial `forgejo-alpine` package ](https://codeberg.org/Eragon/forgejo-alpine )
2023-01-08 19:26:36 +08:00
- **Arch Linux**
- [Arch community `forgejo` package ](https://archlinux.org/packages/community/x86_64/forgejo/ )
- [AUR `forgejo-bin` package ](https://aur.archlinux.org/packages/forgejo-bin )
- [AUR `forgejo-git` package ](https://aur.archlinux.org/packages/forgejo-git )
2023-01-14 17:03:12 +08:00
- **Fedora**
- [RPM copr repo ](https://copr.fedorainfracloud.org/coprs/nalika/gitea/ )
2023-01-08 19:26:36 +08:00
- **NixOS**
- [NixOS unstable ](https://github.com/NixOS/nixpkgs/blob/nixos-unstable/pkgs/applications/version-management/forgejo/default.nix )
2023-01-08 18:14:44 +08:00
2023-01-10 18:27:28 +08:00
### Other packages
- [Helm chart ](https://codeberg.org/forgejo-contrib/forgejo-helm ) - Helm chart for Forgejo, forked from the official Gitea helm chart.
- [YunoHost package ](https://github.com/YunoHost-Apps/forgejo_ynh ) - install Forgejo quickly and simply on a YunoHost server.
2023-01-09 19:31:34 +08:00
## Infrastructure as Code
2023-01-10 18:27:28 +08:00
- [Ansible playbook ](https://lab.enough.community/main/infrastructure/-/tree/master/playbooks/forgejo ) - Deploy Forgejo & Woodpecker, depends on related [Enough Community ](https://enough.community ) playbooks.
2023-01-09 19:31:34 +08:00
2023-01-09 20:18:01 +08:00
## Clients
### Mobile
- [GitNex ](https://gitnex.com/ ) ([repo](https://codeberg.org/gitnex/GitNex)) - Android client for Forgejo and Gitea (`Android – GPL`)
- [GitTouch ](https://github.com/git-touch/git-touch ) - Mobile client for Forgejo, Gitea, GitHub, GitLab, Bitbucket (`Android, iOS – Apache`)
### Command-line
- [tea ](https://gitea.com/gitea/tea ) - the official Gitea CLI client, works with Forgejo (`cross-platform – MIT`)
2023-01-10 18:27:28 +08:00
2023-01-10 19:47:39 +08:00
## Tools
### Bots
- [gitcat ](https://git.mastodont.cat/spla/gitcat ) - Python script that allows sign-up to a Forgejo instance to all local users of a Mastodon server. (`Python - GPLv3`)
2023-01-08 18:14:44 +08:00
## Maintainers
If you have questions or feedback regarding this list, then please create
2023-01-10 19:20:39 +08:00
an [Issue ](https://codeberg.org/forgejo-contrib/delightful-forgejo/issues ) in our tracker, and optionally `@mention` one or more of our maintainers:
2023-01-08 18:14:44 +08:00
- [`@caesar` ](https://codeberg.org/caesar )
2023-01-10 18:27:28 +08:00
2023-01-08 18:14:44 +08:00
## Contributors
With delight we present you some of our [delightful contributors ](delightful-contributors.md ) (please [add yourself ](https://codeberg.org/teaserbot-labs/delightful/src/branch/master/delight-us.md#attribution-of-contributors ) if you are missing).
2023-01-10 18:27:28 +08:00
2023-01-08 18:14:44 +08:00
## License
2023-01-08 19:26:36 +08:00
[![CC0 ](https://mirrors.creativecommons.org/presskit/buttons/88x31/svg/cc-zero.svg )](https://creativecommons.org/publicdomain/zero/1.0/)
To the extent possible under law, the [maintainers ](#maintainers ) and other [contributors ](delightful-contributors.md ) have waived all copyright and related or neighboring rights to this work.