Installing Gogs(git), Nginx, MariaDB on Linux Ubuntu/Mint

The Microsoft bought the GitHub for US$ 7,5 Billions, and the  internet got wild, you can continue using the GitHub,  according to Microsoft, it will keep github as it is.

There are several alternatives as GitLab and the BitBucket, also there are options that are free source/open source that you can install there in your server. The GitLab has a Community version, it is written in Ruby and has a lot of resources, because it has many resources it demands at least a computer with the minimum of  4 GB of memory Ram, to old modests servers we have available the Gogs written in Golang, it is simple but it meets all our basic needs to whom uses the GitHub and it can be installed there in your old computer with 512 MB of memory Ram.


In this tutorial, we go to see how to install the Gogs on ubuntu, from the source code of Gogs, you can also install the Gogs copying the binaries, but if you like to learn the things from the base as me, open your bash there and let’s go

1- Install the database MariaDB (mysql)

To use the Gogs with MariaDB (mysql), it is recomended to use at least the version 10.2 of the MariaDB, in this moment(14/06/2018) while I write this tutorial, the version that there is in the ubuntu official repository is previous to this version, therefore, I am going to install from the MariaDB official repository.

(case your ubuntu is not the 18.04 nor the 16.04, you need to check in the mariadb site the repository of your distro)

#update the repositories data
sudo apt-get update
#install the software that helps to add new repositories
sudo apt-get install software-properties-common

#adding the key of mariadb repository
sudo apt-key adv --recv-keys --keyserver hkp:// 0xF1656F24C74CD1D8

#[18.04] add the repository, repository below for ubuntu 18.04
sudo add-apt-repository 'deb [arch=amd64] bionic main'
#[16.04] add the repository, repository below for ubuntu 16.04
sudo add-apt-repository 'deb [arch=amd64,i386,ppc64el] xenial main'

#update again the repositories data
sudo apt-get update
#install the mariadb
sudo apt-get install mariadb-server
#in the install process, it will ask the password
#that you want to the mariadb root user

#after the install process, configure the mariadb,
#as explained below
sudo mysql_secure_installation

After execute the command mysql_secure_installation, it will ask the password of the root user that was set in the mariadb instalation , after you inform the password it will ask if you want to change the password, say No(N). In the next steps say Yes(Y) to all questions.

Create a user called git in the mariadb, the user will have privileges in the database of the Gogs.

#access the database, inform the root password
mysql -u root -p
--create the git user
--change the password below, to a password of your choice
CREATE USER 'git'@'localhost' IDENTIFIED BY 'password';
--create the database, it is important the character set is in utf8mb4
CREATE DATABASE gogs_production CHARACTER SET utf8mb4 COLLATE utf8mb4_unicode_ci;
--grant the permission to the git user be able to use the database
GRANT ALL PRIVILEGES ON gogs_production.* TO 'git'@'localhost';
--save the permission
--logout the mariadb

2- Install the Nginx and the Git

 sudo apt-get install -y nginx git

For a while we are not going to configure nginx, let’s go to the next steps. We will configure it after that.

3- Install the Gogs

We are going to create a user in the system called git, we are going to put in its home directory, the executable of the language golang  ( we are not going to use the version of the ubuntu repository beacause this version is older than the version of ther official site, we are going to use the version of the official site).  We are going also to put in the home directory of the user git the files of the gogs, and the directory of the repository files, if we need to change something, we will know  that all is concetrated in the home directory of the user git.

Create the user git in the System

#in the bash, create a user git
sudo adduser --disabled-login --gecos 'Gogs' git

Install the language golang

#log with the user created
sudo su - git

#create a directory  to install the golang, and access the directory
mkdir local
cd local

#dowload go
#to know the most recent version,access
#at this moment while I write this tutorial the current stable
#version is 1.10.3
#extraia o arquivo baixado
tar zxvf go1.10.3.linux-amd64.tar.gz

#Setting the environment

cd ~
echo 'export GOROOT=$HOME/local/go' >> $HOME/.bashrc
echo 'export GOPATH=$HOME/go' >> $HOME/.bashrc
echo 'export PATH=$PATH:$GOROOT/bin:$GOPATH/bin' >> $HOME/.bashrc
source $HOME/.bashrc

Install the gogs

#still logged with the git user
#download and install the dependencies
go get -u

# compile the main program
cd $GOPATH/src/
go build

#still inside the directory $GOPATH/src/
#create the directory below to customise the settings of the gogs
mkdir -p custom/conf
#copy the settings file
cp conf/app.ini custom/conf/

Setting the gogs

#open the settings file created in the previous step
nano custom/conf/app.ini

!! In the section [service] you can restrict the extern access, and the creation of new users, changing the key DISABLE_REGISTRATION for true, only the administrator user will be able to create new users, and changing the key REQUIRE_SIGNIN_VIEW for true, only logged users will have access to the repositories !!

Change the follow lines, in the sections below:

[repository] ;section - directory of the repositories

[database] ;section -- change the password, for the password that you created for the git user of the mariadb database
DB_TYPE = mysql
NAME = gogs_production
USER = git
PASSWD = pass

[service] ;section -- change the two keys below, for true
; Does not allow register and admin create account only
; User must sign in to view anything.

Save the file with the keyss CTRL+x, and press Y to confirm.

Now we go to setting the Gogs to initialize along with the system through init.d

#get back to the home of git user
cd ~
#copy the script which already comes prepared for the ubuntu(debian)
cp $GOPATH/src/ ./gogs.init
#edit the file
nano gogs.init

-change these two lines in the begin of the file, from:

# Required-Start: $syslog $network
# Required-Stop: $syslog


# Required-Start: $syslog $network mysql nginx
# Required-Stop: $syslog $local_fs

Below in the same file, type the path where is the directory of gogs for the init.d be able to find the installation directory of it, changing the line WORKING_DIR for:


Save the file with the keys CTRL+x, and press Y to confirm.

The next steps will be made with your user, make logout from git user and follow the next steps

#making logout from git user
#move the file which we edited in the previous step to the init scripts directory.
sudo mv /home/git/gogs.init /etc/init.d/gogs
#grant permission of execution to it
sudo chmod ug+x /etc/init.d/gogs
#and finally enable it to it initialize along with the system
sudo update-rc.d gogs defaults 30 70

Now we go to configure the Nginx,  to use gogs service through nginx:

!! If you already used the nginx for another process/service, you can use another port different from 80, but if you didn’t use it, you can keep the port 80 in the setting file like we are going to do in this step !!

#delete the standard site of nginx
#only delete if you don't use the nginx to another service
#if you use to another service, jump to the next command
sudo rm /etc/nginx/sites-enables/default

#create the file of the gogs service in the nginx
sudo nano /etc/nginx/sites-available/gogs

Paste the content below in the file:

server {
    listen 80; #port 80

    location / {
        proxy_pass https://localhost:3000; #url of the gogs

Save the file with the keys CTRL+x, and press Y to confirm

#create a symlink from the setting file created,
#to the directory of enabled sites of the nginx
sudo ln -s /etc/nginx/sites-available/gogs /etc/nginx/sites-enabled/gogs

Start the services

#start the service of the gogs
sudo service gogs start
#restart the service of the nginx, that way it will recognize
#the new settings
sudo service nginx restart

Using the browser, open the address  https://localhost, or https://localhost:num_port if you have used a different port of 80

If this is the first time you access the gogs, it will be presented a screen like this. In this screen you will inform the settings and create the main user.

gogs installation

Review if the data is correct, Database Type* must be as MySql, in the area  “Admin Account Settings”  type the name, email and the  pass of the admin user. After this just click on “Install Gogs”. If you made all the steps correctly the system will configure the database, and then it will show the initial screen of the system, with the admin user already logged in.

Enjoy your new git/gogs server.

Leave a Reply

Your email address will not be published. Required fields are marked *