Gitea

Gitea
CaptainStack · CC BY-SA 4.0 · source
Name	Gitea
Developer	Gitea Community
Initial release	2016
Written in	Go
License	MIT License
Repository	Gitea main

Gitea is a lightweight, open-source distributed version control and source code management platform implemented in the Go programming language. It provides Git repository hosting, issue tracking, code review, and continuous integration integrations for self-hosted and containerized environments. The project emerged from a fork and community governance model to provide a minimal, extensible alternative to larger platforms while interoperating with ecosystem tools and protocols.

History

The project originated in 2016 following discussions among contributors from GitHub, Bitbucket (Atlassian), SourceForge, Launchpad (software), GNU Savannah and other hosting projects who sought a simpler, self-hostable solution. Early maintainers included developers active in Gogs and contributors with backgrounds in Linux Mint, Debian, Arch Linux, and Fedora Project packaging. Governance evolved with input from participants linked to Open Source Initiative, Free Software Foundation, Apache Software Foundation, and veterans from the Go (programming language) community such as contributors previously involved with Docker, Kubernetes, and Prometheus (software). Over time, the codebase incorporated patterns popularized by GitLab and Phabricator while emphasizing small footprint and portability for platforms like Raspberry Pi, Alpine Linux, and Windows Server. The project has participated in events including FOSDEM, LinuxCon, Open Source Summit, and programs resembling Google Summer of Code.

Architecture and features

Gitea's architecture centers on a monolithic Go application that exposes Git operations over SSH, HTTP(S), and the Git protocol, integrating with databases such as MySQL, PostgreSQL, SQLite, and Microsoft SQL Server. Its core features include repository hosting, pull request workflows, issue tracking, milestone management, code review with inline comments, and an integrated Wiki and file editor. The platform integrates with external authentication systems like LDAP, OAuth, SAML, and services including GitHub Actions-style CI via webhooks for Jenkins, Travis CI, CircleCI, and Drone CI. Gitea supports repository mirroring, web-based merge conflict handling, repository search, syntax highlighting powered by components influenced by Chroma (syntax highlighter), and LFS support interoperable with Git LFS. For scalability, deployments may employ reverse proxies such as NGINX, Apache HTTP Server, or Caddy (web server), load balancing with HAProxy, and storage backends including NFS or object storage systems influenced by MinIO and Ceph.

Installation and deployment

Installation options include prebuilt binaries, distribution packages maintained by communities like Debian, Ubuntu, CentOS, Alpine Linux, container images for Docker (software) and orchestration on Kubernetes, and single-file deployments suitable for devices such as Raspberry Pi or virtual appliances used in VMware ESXi and Proxmox VE. System administrators commonly configure TLS with Let's Encrypt certificates, manage secrets with tools inspired by Vault (software), and automate provisioning using Ansible, Puppet, Chef (software), or Terraform. Backup and disaster recovery strategies align with patterns used in PostgreSQL and MySQL ecosystems, and continuous deployment pipelines often integrate with GitOps workflows exemplified by Argo CD and Flux (software).

Development and community

The project is developed collaboratively by volunteers, organizations, and contributors from companies and projects such as Huawei, Tencent, Red Hat, Canonical, and independent developers active in Go (programming language) ecosystems. Governance follows community-oriented processes with issue tracking and pull requests hosted in the project repository, and discussions occurring on platforms like Discourse, Matrix (protocol), IRC, and GitHub (company). Contributors follow coding conventions influenced by Effective Go and testing practices used by projects like GolangCI-Lint and Testify (Go package). The community participates in conferences including GopherCon, DevConf, and regional meetups, and has run mentorship initiatives similar to Outreachy and Google Summer of Code.

Adoption and use cases

Gitea is adopted by educational institutions, research labs, small and medium enterprises, and open-source projects that require lightweight, self-hosted source control. Notable use cases include classroom assignments managed by universities that use tooling common in Moodle, internal developer platforms at companies with integrations like Jenkins or GitLab CI/CD replacements, mirror hosts for projects previously hosted on Bitbucket (Atlassian) or migrating from GitHub Enterprise, and embedded deployments on devices in IoT projects. Organizations valuing minimal operational overhead deploy Gitea for internal tooling, documentation wikis, and lightweight continuous integration, often alongside monitoring stacks inspired by Prometheus (software), logging via ELK Stack, and container registries like Harbor (software).

Category:Version control systems