Installing Gogs on Ubuntu 22.04

Gogs is a self-hosted Git service written in Go. It is a lightweight and fully customizable platform that allows you to create and manage Git repositories on your own server. In this tutorial, we will guide you through the process of installing Gogs on Ubuntu 22.04.

Step 1: Update System Packages

Before installing Gogs, it is recommended to update the system packages to their latest versions. Open the terminal and run the following commands:

$ sudo apt update
$ sudo apt upgrade

Step 2: Install Required Packages

Gogs requires a few dependencies to run properly. We can install them by executing the following command:

$ sudo apt install git sqlite3

Step 3: Create a New User

It is recommended to create a dedicated system user for running Gogs. You can create a new user with the following command:

$ sudo adduser --system --shell /bin/bash --group --disabled-password --home /home/git git

Step 4: Download and Extract Gogs

Now, navigate to the user's home directory and download the latest Gogs release from the official website. Extract the downloaded archive using the following commands:

$ cd /home/git
$ wget https://dl.gogs.io/VERSION/gogs_VERSION_linux_amd64.tar.gz
$ tar -xzf gogs_VERSION_linux_amd64.tar.gz

Note: Replace VERSION with the desired Gogs version number.

Step 5: Configure Gogs

Next, we need to configure Gogs to specify the server's IP address and port, database settings, and other options. Copy the sample configuration file to the actual configuration file using the following commands:

$ cp /home/git/gogs/CUSTOM/conf/app.ini /home/git/gogs/conf/app.ini
$ nano /home/git/gogs/conf/app.ini

Inside the app.ini file, modify the necessary fields according to your preferences and save the changes.

Step 6: Start Gogs Service

To start the Gogs service, run the following command:

$ sudo systemctl start gogs

To automatically start Gogs on system boot, enable the service using the following command:

$ sudo systemctl enable gogs

Step 7: Access Gogs Web Interface

Now that Gogs is up and running, you can access its web interface by opening a web browser and entering the server's IP address or domain name followed by the Gogs port number (default is 3000). For example, if your server's IP address is 192.168.0.100, you can access Gogs by entering http://192.168.0.100:3000 in the browser's address bar.

Follow the on-screen instructions to complete the initial setup, including creating the administrator account and setting up the first repository.

Congratulations! You have successfully installed Gogs on Ubuntu 22.04. Now you can use Gogs to create, manage, and collaborate on Git repositories from your own server.