How to Install Gogs on Ubuntu 24.04

Set up Ubuntu

Preparing Ubuntu for Gogs involves installing Git, which helps manage code, and creating a dedicated user account for Gogs to run securely. First, update your system’s package list and install Git with: sudo apt update && sudo apt install git. This readies your Ubuntu system for Gogs installation.

To complete these actions, run the command below to install Git.

sudo apt update
sudo apt install git

sudo adduser --system --group --disabled-password --shell /bin/bash --home /home/git --gecos 'Git Version Control' git

If the command above ran successfully, you should see a similar output.

info: Selecting GID from range 100 to 999 ...
info: Adding system user `git' (UID 122) ...
info: Adding new group `git' (GID 124) ...
info: Adding new user `git' (UID 122) with group `git' ...
info: Creating home directory `/home/git' ...

Install MariaDB

You need to install MariaDB to store Gogs’ crucial data, such as your repositories and user information. After installing the MariaDB server, you’ll create a specific database exclusively for Gogs. To install MariaDB, run the command: sudo apt install mariadb-server. This sets up the necessary database for Gogs to function.

Run the command below to install MariaDB.

sudo apt install mariadb-server

After installing MariaDB, create an empty database for Gogs.

Run the command below to access the MariaDB database server.

sudo mariadb

SET GLOBAL innodb_file_per_table = ON;

Next, create a Gogs database named gogsdb

CREATE DATABASE gogsdb;

Then, create a database user named gogsuser with a new password.

CREATE USER 'gogsuser'@'localhost' IDENTIFIED BY 'Type_new_password_here';

After that, run the command below to grant the user complete access to the database.

GRANT ALL ON gogsdb.* TO 'gogsuser'@'localhost' WITH GRANT OPTION;

Next, run the commands below to update the database character set.

ALTER DATABASE gogsdb CHARACTER SET = utf8mb4 COLLATE utf8mb4_unicode_ci;

Finally, save your modifications and exit.

FLUSH PRIVILEGES;
EXIT;

Download and install Gogs

With your Ubuntu system and MariaDB prepared, you can now download and install Gogs. Fetch the latest version directly from the official GitHub releases page. To download Gogs, first navigate to the temporary directory using `cd /tmp`. Then, use `wget` to download the Gogs file, replacing the version number with the latest release from GitHub.

To download the latest files, use the link below.

https://github.com/gogs/gogs/releases

Run the commands below to download the Gogs file. Replace the version number with the latest.

cd /tmp
wget https://github.com/gogs/gogs/releases/download/v0.13.2/gogs_0.13.2_linux_amd64.tar.gz

Then extract the downloaded file into the Git user’s home directory (the one created earlier) using the commands below:

sudo tar xvf gogs_0.13.2_linux_amd64.tar.gz
 -C /home/git

After that, give the Git user ownership of the Gogs folder.

sudo chown -R git: /home/git/gogs

Next, create Gogs service scripts by moving them from the user directory to the system directory.

sudo cp /home/git/gogs/scripts/systemd/gogs.service /etc/systemd/system/

Once complete, reload systemd and start the Gogs services.

sudo systemctl daemon-reload
sudo systemctl enable gogs
sudo systemctl start gogs

To check Gogs’ status, run the commands below:

sudo systemctl status gogs

You should see a similar message below:

gogs.service - Gogs
     Loaded: loaded (/etc/systemd/system/gogs.service; enabled; preset: enabled)
     Active: active (running) since Wed 2025-03-19 10:33:58 CDT; 6s ago
   Main PID: 4839 (gogs)
      Tasks: 6 (limit: 4551)
     Memory: 34.2M (peak: 34.5M)
        CPU: 109ms
     CGroup: /system.slice/gogs.service
             └─4839 /home/git/gogs/gogs web

Gogs should be installed and ready for configuration.

Open your browser and navigate to the server hostname or IP address followed by port 3000.

http://localhost:3000/install

You should see Gogs’ initial web setup portal.

On the page, select the database type, enter the database name, and provide the user account and password.

Then, expand the admin account settings and create an admin account. Click ‘Install Gogs.’

Gogs should now be ready to use. Log in.

That completes the process!

Conclusion:

Gogs provides a powerful self-hosted Git service to simplify repository management. You can successfully install and configure Gogs on your Ubuntu 24.04 machine by following the steps in this article. Remember that Gogs excels at managing repositories and that the installation process on Ubuntu 24.04 has been detailed.

• Gogs provides a user-friendly interface for managing Git repositories.
• Installation involves setting up Git, MariaDB, and the Gogs application itself.
• Ensure database setup includes creating a dedicated user and granting proper access rights.
• Access the Gogs installation portal through your web browser to complete the configuration.
• Regularly check the service status to ensure everything is running smoothly.

Gogs is now ready for you to use, enhancing your development workflow efficiently!