Skip to main content

README Highlight Issue #44, 2023: Gitea

In this week’s issue of README Highlight (#44, 2023), we are taking a look at the project Gitea. Gitea is a self-hosted Git service that aims to provide an easy, fast, and painless way to set up a Git server.

One of the notable features of Gitea is that it is written in Go, making it compatible with all platforms and architectures supported by Go, including Linux, macOS, and Windows on x86, amd64, ARM, and PowerPC architectures. It also provides an online demo for users to try out.

To build Gitea, you can run the command TAGS="bindata" make build from the root of the source tree. If SQLite support is required, you can use TAGS="bindata sqlite sqlite_unlock_notify" make build. The build process consists of two sub-targets: make backend which requires Go Stable, and make frontend which requires Node.js LTS or greater.

To use Gitea, you can simply run ./gitea web command. If you are interested in using the APIs, there is experimental support with documentation available.

Contributing to Gitea follows the workflow of Fork -> Patch -> Push -> Pull Request. It is important to read the Contributors Guide before starting to work on a pull request. For security vulnerabilities, it is recommended to contact the project privately at [email protected].

Translations of Gitea are done through Crowdin, and new languages can be added by requesting it through the Crowdin project or by creating an issue. Further information and instructions about installing Gitea can be found in the documentation. Questions that are not covered by the documentation can be addressed on the Discord server or the discourse forum.

Gitea has a list of related projects called awesome-gitea, and the official Gitea CLI is developed at gitea/tea.

The project is licensed under the MIT License. For screenshots and an overview of the interface, you can visit the provided links.

Overall, Gitea is a versatile and user-friendly self-hosted Git service that provides a seamless experience for setting up a Git server. With its compatibility across platforms and architectures, it offers flexibility and convenience for users in the server, Linux, DevOps, and home lab communities.

Source: Gitea README.