Gitea installation on Ubuntu 20.04

Gitea is one of the most well-known self-hosted Git servers and is written in the Go programming language. Gitea includes a file editor for the repository, user management, wiki, project issue tracking, and so on.

Besides the many pros of Gitea, it’s also a lightweight application that doesn’t require much of the resources of your computer.

This article will show you the steps to install Gitea on your Ubuntu 20.04 machine.

Install pre-enquiries

Firstly, let’s update the software packages list then upgrade your Ubuntu 20.04 machine by running the following commands:

$ sudo apt update
$ sudo apt upgrade

Please make sure that SQLite will be installed.

$ sudo apt install sqlite3

You can also install MySQL, PostgreSQL, or MariaDB for the database backends. In this tutorial, we will use SQLite.

Install SQLite

Install Gitea

You can install Gitea in some ways such as: using a Docker image, installing from source code, or binary. This guide will show you the way to install Gitea from binary.

First, let’s install Git on your Ubuntu machine:

$ sudo apt install git

Verify whether Git is successfully installed or not:

$ git --version

Install GIT and check GIT version afterwards

Then, let’s create a Git user by running the following command:

$ sudo adduser --system --gecos 'Version Control' --group --disabled-password git

Add Linux user for GIT

The next step is downloading the Gitea binary. At the time of this writing, the latest version of Gitea is v.14.3.

$ wget https://dl.gitea.io/gitea/1.14.3/gitea-1.14.3-linux-amd64

Now, let’s move the gitea binary file to the /usr/local/bin directory then grant it the execute permission.

$ sudo mv gitea-1.14.3-linux-amd64 /usr/local/bin/gitea
$ sudo chmod +x /usr/local/bin/gitea

Next, you have to create the following directories and establish suitable permissions and ownership for git user:

$ sudo mkdir -p /var/lib/gitea/{custom,data,log}
$ sudo chown -R git:git /var/lib/gitea/
$ sudo chmod -R 750 /var/lib/gitea/
$ sudo mkdir /etc/gitea
$ sudo chown root:git /etc/gitea/
$ sudo chmod 770 /etc/gitea/

It’s necessary to run Gitea as a systemd service. Let’s download the sample systemd unit file from the gitea site.

$ sudo wget https://raw.githubusercontent.com/go-gitea/gitea/main/contrib/systemd/gitea.service -P /etc/systemd/system/

Then, enable and start the service:

$ sudo systemctl daemon-reload
$ sudo systemctl enable --now gitea

Verify that the Gitea service is running:

$ sudo systemctl status gitea.service

set up Gitea systemd service

Configure Gitea

By default, the Gitea is running on port 3000. If you enable the firewall on your Ubuntu 20.04 machine, you need to allow traffic on port 3000:

$ sudo ufw allow 3000/tcp

Open your browser and visit the Gitea site at http://YOUR_DOMAIN_OR_IP:3000

Gitea configuration

Gitea port

Let the settings be as the above pictures. Hit the “Install Gitea” button to start the installation.

In the following step, register an account.

Login to Gitea

Fill up the necessary information:

Register a new user

That’s all. Gitea has been successfully installed on your Ubuntu 20.04 machine.

Gitea on Ubuntu

Gitea has been successfully installed on our Ubuntu 20.04 system.

Leave a Comment

*