How to Install Gogs Git on Ubuntu 22.04
This tutorial will walk you through the steps necessary to install the Gogs self-hosted Git service on an Ubuntu 22.04 server. The Gogs project, written in Go, aims to create a simple, stable, and extensible self-hosted Git service with a simple setup process.
Gogs performs admirably and is extremely light. It uses very little RAM and CPU power.
Checkout the Gogs Project at https://gogs.io/ for more information.
Prerequisites
- Full SSH root access or a user with sudo privileges is required.
- Gogs supports the following databases.
- SQLite3
- PostgreSQL
- MySQL
- MariaDB
First, check for any pending system upgrade
Let's update software packages first. To perform updates, run the following command:
apt update
apt upgrade
Install MariaDB Database Server
Use the below command to install MariaDB.
apt install mariadb-server mariadb-client
Check the status of MariaDB service.
root@crown~# systemctl status mariadb
● mariadb.service - MariaDB 10.6.9 database server
Loaded: loaded (/lib/systemd/system/mariadb.service; enabled; preset: enab>
Active: active (running) since Sat 2022-11-19 17:44:57 UTC; 8s ago
Docs: man:mariadbd(8)
https://mariadb.com/kb/en/library/systemd/
Process: 1808 ExecStartPre=/usr/bin/install -m 755 -o mysql -g root -d /var>
Process: 1811 ExecStartPre=/bin/sh -c systemctl unset-environment _WSREP_ST>
Process: 1818 ExecStartPre=/bin/sh -c [ ! -e /usr/bin/galera_recovery ] && >
Process: 1876 ExecStartPost=/bin/sh -c systemctl unset-environment _WSREP_S>
Process: 1878 ExecStartPost=/etc/mysql/debian-start (code=exited, status=0/>
Main PID: 1862 (mariadbd)
Status: "Taking your SQL requests now..."
Tasks: 15 (limit: 2227)
Memory: 61.6M
CPU: 418ms
CGroup: /system.slice/mariadb.service
└─1862 /usr/sbin/mariadbd
Secure the MariaDB Installation with the below command,
mysql_secure_installation
Output:
Enter current password for root (enter for none):
OK, successfully used password, moving on...
Setting the root password ensures that nobody can log into the MariaDB
root user without the proper authorisation.
Set root password? [Y/n] y
New password:
Re-enter new password:
Password updated successfully!
Reloading privilege tables..
... Success!
Login to MariaDB as root
user,
mariadb -u root -p
Enable global variables as shown below,
SET GLOBAL innodb_file_per_table = ON;
Create a database called gogs
which will be used for this project,
CREATE DATABASE IF NOT EXISTS gogs CHARACTER SET utf8mb4 COLLATE utf8mb4_general_ci;
Create a user and grant all the privileges of the gogs database,
GRANT ALL PRIVILEGES ON gogs.* TO 'gogs'@'localhost' IDENTIFIED BY "StrongPassword";
Replace "StrongPassword" with an actual password that is long and strong.
FLUSH PRIVILEGES;
EXIT
Download and Install Gogs
from GitHub
Use curl
to download the Gogs
file from their official github repository.
curl -s https://api.github.com/repos/gogs/gogs/releases/latest | grep browser_download_url | grep '\linux_amd64.tar.gz' | cut -d '"' -f 4 | wget -i -
Un-tar the downloaded Gogs
file.
tar xvf gogs_*_linux_amd64.tar.gz
Create a new user called git
,
adduser git
Create a dedicated logs directory for it's user,
mkdir /var/log/gogs
Permit created directory access to the added user,
chown -R git:git /var/log/gogs/
Add the gogs
systemd service file to the system directory at /etc/systemd/system/
,
cp gogs/scripts/systemd/gogs.service /etc/systemd/system
Create a configuration file for Gogs
,
nano /etc/systemd/system/gogs.service
If you want to make use of a different port to host Gogs, refer below.
You can use any other port you want to, this is to keep the site a bit safer.
Edit the ExecStart=/home/git/gogs web
port, you can set a custom port such as 3001
ExecStart=/home/git/gogs/gogs web -port 3001
Move the Gogs binary file to /home/git
,
mv gogs /home/git/
Change the permission of the site directory.
chown -R git:git /home/git/
To start the Gogs
service.
systemctl daemon-reload
systemctl start gogs
Enable Gogs service to run on boot and check the Status,
systemctl enable gogs
systemctl status gogs
Output:
root@crown:~# systemctl status gogs
● gogs.service - Gogs
Loaded: loaded (/etc/systemd/system/gogs.service; enabled; preset: enabled)
Active: active (running) since Sat 2022-11-19 17:51:21 UTC; 10s ago
Main PID: 3281 (gogs)
Tasks: 6 (limit: 2227)
Memory: 34.5M
CPU: 271ms
CGroup: /system.slice/gogs.service
└─3281 /home/git/gogs/gogs web -port 3001
Configure Gogs
Navigate to your browser and load the server's IP address or the domain name with 3001
port.
http://server-ip-address:3001
and you will see the Gogs
installation screen.
In Database Settings we'll first enter the Database information that was created earlier.
Next, In Application General Settings
- Application Name - enter the Project name of your choice.
- Run User - will be the new user that was added earlier,
git
. - Domain - enter the Domain name that should be associated with the application. If you do not have any domain, use
localhost
. - Application URL - enter the IP address of the server or the Domain name with the port to be used.
Do not use localhost in Application URL.
- Log Path - enter the directory path that was created earlier,
/var/log/gogs
.
In Optional Settings,
- Enable or Disable the required settings that goes with your application usage.
- Create an Admin Account which you will be using as first user with Admin privileges.
Now click on Install Gogs button to start the installation. Once the installation is complete, you will be redirected to login screen.
Login with the Admin user that was just created in the last step.
This concludes the Installation and Gogs on Ubuntu 22.04
CrownCloud - Get a SSD powered KVM VPS at $4.5/month!
Use the code WELCOME
for 10% off!
1 GB RAM / 25 GB SSD / 1 CPU Core / 1 TB Bandwidth per month
Available Locations: LAX | MIA | ATL | FRA | AMS