ποΈ Compared to other Git hosting
To help decide if Gitea is suited for your needs, here is how it compares to other Git self hosted options.
ποΈ Database Preparation
You need a database to use Gitea. Gitea supports PostgreSQL (>= 12), MySQL (>= 8.0), MariaDB (>= 10.4), SQLite (builtin), and MSSQL (>= 2012 SP4). This page will guide into preparing database. Only PostgreSQL and MySQL will be covered here since those database engines are widely-used in production. If you plan to use SQLite, you can ignore this chapter.
ποΈ Installation from binary
All downloads come with SQLite, MySQL and PostgreSQL support, and are built with
ποΈ Official packages
macOS
ποΈ Installation from source
You should install go and set up your go
ποΈ Run as Linux service
You can run Gitea as service, using either systemd or supervisor. The steps below tested on Ubuntu 16.04, but those should work on any Linux distributions (with little modification).
ποΈ Register as a Windows Service
Prerequisites
ποΈ Installation with Docker (rootless)
Gitea provides automatically updated Docker images within its Docker Hub organization. It is
ποΈ Installation with Docker
Gitea provides automatically updated Docker images within its Docker Hub organization. It is
ποΈ Install on Kubernetes
Gitea provides a Helm Chart to allow for installation on kubernetes.
ποΈ Installation on Cloud Provider
Cloudron
ποΈ Upgrade from an old Gitea
Follow below steps to ensure a smooth upgrade to a new Gitea version.
ποΈ Upgrade from Gogs
Gogs, version 0.9.146 and older, can be easily migrated to Gitea.