Did You Know?

How Can We Help?

Special Offer

Deploy your Cloud Server now and get $100 in Free Credits!

Get Started

How to install Gogs on Ubuntu 20.04

Table of Content
How to install Gogs on Ubuntu 20.04


In this article, you will learn how to install Gogs on Ubuntu 20.04.

Gogs is a git server that is self-hosted and open source. It was created in Go. It comes with a file editor for the repository, tracking for the project issues, and a wiki that is built right in.

Gogs is a lightweight application that may be loaded on low-powered devices because of its low memory and CPU requirements. You should give Gogs a shot if you are looking for an alternative to Gitlab that has a significantly smaller memory footprint and if you do not want all of the bells and whistles that Gitlab provides. The steps necessary to install Gogs on Ubuntu 20.04 are outlined in this tutorial.

Before You Begin

All of Gogs' data can be stored in either a SQLite, PostgreSQL, or MySQL/MariaDB database depending on the user's preference.

We will be utilising SQLite as our database of choice throughout this course. You can install SQLite on your computer by putting in the following command, if it has not already been done so.

[console]# apt install sqlite3 -y[/console]

Installing Gogs

The Gogs binary will be used for the installation. The process of installation is pretty easy to understand and follow.

Installing Git on your server is the first thing you need to do. In order to accomplish this, you must first update the local package index and then install the git package by executing the command below.

[console]# apt update[/console]

[console]# apt install git[/console]

Displaying the Git version will allow you to validate the installation.

[console]# git --version[/console]


Simply typing in the following command will create a new user account for the Gogs service.

[console]# adduser --system --group --disabled-password --shell /bin/bash --home /home/git --gecos 'Git Version Control' git[/console]

command output

Download Gogs binary

Go to the Gogs Download page to get the most recent version of the binary that is compatible with your architecture. The most recent version, as of this writing, is 0.11.86; however, if there is a newer version available, the VERSION variable in the command that follows should be updated accordingly.

[console]# VERSION=0.11.86[/console]

The following wget command must be used in order to download the Gogs archive into the /tmp directory:

[console]# wget https://dl.gogs.io/${VERSION}/gogs_${VERSION}_linux_amd64.tar.gz -P /tmp[/console]

As soon as the download is finished, extract the Gogs tar.gz file, and then move it into the /home/git directory:

[console]# tar xf /tmp/gogs_*_linux_amd64.tar.gz -C /home/git[/console]

Execute the following command to transfer ownership of the directory containing the Gogs installation to the user and group git:

[console]# chown -R git: /home/git/gogs[/console]

Create a systemd Unit File

Gogs includes a Systemd unit file that, out of the box, is already configured to work with our infrastructure.

Simply type in the following command to copy the file into the /etc/systemd/system/ directory:

[console]# cp /home/git/gogs/scripts/systemd/gogs.service /etc/systemd/system/[/console]

After that, run the Gogs service and make sure it's enabled:

[console]# systemctl enable gogs[/console]

[console]# systemctl start gogs[/console]

[console]# systemctl status gogs[/console]


Install Gogs using the web installer

It is time to finalise the installation using the web interface now that Gogs has been downloaded and is operating successfully.

Open your browser, type http://your_ip:3000 and a screen similar to the following will appear:

 install Gogs on Ubuntu 20.04
Database Settings:
  • Database Type: SQLite3
  • Path: Use an absolute path, /home/git/gogs/gogs.db

Application General Settings

  • Application Name: Enter your organization name
  • Repository Root Path: Leave the default /home/git/gogs-repositories
  • Run User: git
  • Domain: Enter your domain or server IP address.
  • SSH Port: 22, change it if SSH is listening on other Port
  • HTTP Port: 3000
  • Application URL: Use http and your domain or server IP address.
  • Log Path: Leave the default /home/git/gogs/log

Once done hit the “Install Gogs” button. The installation is instant and when completed you will be redirected to the login page.


Hopefully, you have learned how to install Gogs on Ubuntu 20.04.

Thank You 🙂

Special Offer

Deploy your Cloud Server now and get $100 in Free Credits!

Get Started
Table of Contents