- \n
- Ubuntu 16.04<\/li>\n
- Root privileges<\/li>\n<\/ul>\n
What we will do<\/h2>\n
- \n
- Update and Upgrade System<\/li>\n
- Install and Configure PostgreSQL<\/li>\n
- Install Go and Git<\/li>\n
- Install Gogs<\/li>\n
- Configure Gogs<\/li>\n
- Running Gogs as a Service<\/li>\n
- Install and Configure Nginx as a Reverse Proxy<\/li>\n
- Testing<\/li>\n<\/ol>\n
Step 1 – Update and Upgrade System<\/h2>\n
Before going any further, update all Ubuntu repositories and upgrade all packages.<\/p>\n
Run the apt commands below.<\/p>\n
sudo apt update
sudo apt upgrade<\/p>\nStep 2 – Install and Configure PostgreSQL<\/h2>\n
Gogs offers support for MySQL, PostgreSQL, SQLite3, MSSQL, and TiDB database systems.<\/p>\n
In this guide, we will be using PostgreSQL as a database for our Gogs installations.<\/p>\n
Install PostgreSQL using the apt command below.<\/p>\n
sudo apt install -y postgresql postgresql-client libpq-dev<\/p>\n
After the installation is complete, start the PostgreSQL service and enable it to launch everytime at system boot.<\/p>\n
systemctl start postgresql
systemctl enable postgresql<\/p>\nPostgreSQL database has been installed on an Ubuntu system.<\/p>\n
Next, we need to create a new database and user for Gogs.<\/p>\n
Login as the ‘postgres’ user and run the ‘psql’ command to get the PostgreSQL shell.<\/p>\n
su – postgres
psql<\/p>\nCreate a new user named ‘git’, and give the user privileges for ‘CREATEDB’.<\/p>\n
CREATE USER git CREATEDB;
\\password git<\/p>\nCreate a database named ‘gogs_production’, and set the ‘git’ user as the owner of the database.<\/p>\n
CREATE DATABASE gogs_production OWNER git;<\/p>\n
![\"Create](\"https:\/\/afaghhosting.net\/blog\/wp-content\/uploads\/2018\/02\/how-to-install-gogs-go-git-service-on-ubuntu-16-04.png\" "\\"\\"")
<\/a><\/p>\nNew PostgreSQL database ‘gogs_production’ and user ‘git’ for Gogs installation has been created.<\/p>\n
Step 3 – Install Go and Git<\/h2>\n
Install Git from the repository using the apt command below.<\/p>\n
sudo apt install git<\/p>\n
Now add new user ‘git’ to the system.<\/p>\n
sudo adduser –disabled-login –gecos ‘Gogs’ git<\/p>\n
Login as the ‘git’ user and create a new ‘local’ directory.<\/p>\n
su – git
mkdir -p \/home\/git\/local<\/p>\nGo to the ‘local’ directory and download ‘Go’ (the latest version) using the wget command as shown below.<\/p>\n
cd ~\/local
wget https:\/\/dl.google.com\/go\/go1.9.2.linux-amd64.tar.gz<\/p>\n![\"Install](\"https:\/\/afaghhosting.net\/blog\/wp-content\/uploads\/2018\/02\/how-to-install-gogs-go-git-service-on-ubuntu-16-04-1.png\" "\\"\\"")
<\/a><\/p>\nExtract the go compressed file, then remove it.<\/p>\n
tar -xf go1.9.2.linux-amd64.tar.gz
rm -f go1.9.2.linux-amd64.tar.gz<\/p>\n‘Go’ binary file has been downloaded in the ‘~\/local\/go’ directory. Now we need to setup the environment – we need to define the ‘GOROOT’ and ‘GOPATH directories so we can run a ‘go’ command on the system under ‘git’ user.<\/p>\n
Run all of the following commands.<\/p>\n
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<\/p>\nAnd reload Bash by running the ‘source ~\/.bashrc’ command as shown below.<\/p>\n
source ~\/.bashrc<\/p>\n
Make sure you’re using Bash as your default shell.<\/p>\n
![\"Install](\"https:\/\/afaghhosting.net\/blog\/wp-content\/uploads\/2018\/02\/how-to-install-gogs-go-git-service-on-ubuntu-16-04-2.png\" "\\"\\"")
<\/a><\/p>\nNow run the ‘go’ command for checking the version.<\/p>\n
go version<\/p>\n
And make sure you get the result as shown in the following screenshot.<\/p>\n
![\"Check](\"https:\/\/afaghhosting.net\/blog\/wp-content\/uploads\/2018\/02\/how-to-install-gogs-go-git-service-on-ubuntu-16-04-3.png\" "\\"\\"")
<\/a><\/p>\nGo is now installed on the system under ‘git’ user.<\/p>\n
Step 4 – Install Gogs Go Git Service<\/h2>\n
Login as the ‘git’ user and download ‘Gogs’ from GitHub using the ‘go’ command.<\/p>\n
su – git
go get -u github.com\/gogits\/gogs<\/p>\nThe command will download all Gogs source code in the ‘GOPATH\/src’ directory.<\/p>\n
Go to the ‘$GOPATH\/src\/github.com\/gogits\/gogs’ directory and build gogs using commands below.<\/p>\n
cd $GOPATH\/src\/github.com\/gogits\/gogs
go build<\/p>\nAnd make sure you get no error.<\/p>\n
Now run Gogs Go Git Service using the command below.<\/p>\n
.\/gogs web<\/p>\n
The command will run Gogs on the default port 3000.<\/p>\n
![\"Install](\"https:\/\/afaghhosting.net\/blog\/wp-content\/uploads\/2018\/02\/how-to-install-gogs-go-git-service-on-ubuntu-16-04-4.png\" "\\"\\"")
<\/a><\/p>\nOpen your web browser and type your server IP address with port 3000, mine is http:\/\/192.168.33.10:3000\/<\/p>\n
And you should get the result as shown below.<\/p>\n
![\"Gogs](\"https:\/\/afaghhosting.net\/blog\/wp-content\/uploads\/2018\/02\/how-to-install-gogs-go-git-service-on-ubuntu-16-04-5.png\" "\\"\\"")
<\/a><\/p>\nGogs is installed on the Ubuntu system. Now back to your terminal and press ‘Ctrl + c’ to exit.<\/p>\n
Step 5 – Configure Gogs Go Git Service<\/h2>\n
In this step, we will create a custom configuration for Gogs.<\/p>\n
Goto the Gogs installation directory and create a new ‘custom\/conf’ directory.<\/p>\n
cd $GOPATH\/src\/github.com\/gogits\/gogs
mkdir -p custom\/conf\/<\/p>\nCopy default configuration to the custom directory and edit it using vim<\/a>.<\/p>\n
cp conf\/app.ini custom\/conf\/app.ini
vim custom\/conf\/app.ini<\/p>\nIn the ‘[server]<\/strong>‘ section, change the server ‘HOST_ADDR’ with ‘127.0.0.1’.<\/p>\n
[server]
In the ‘[database]<\/strong>‘ section, change everything with your own database info.<\/p>\n
[database]
Save and exit.<\/p>\n
Now verify the configuration by running the command as shown below.<\/p>\n
.\/gogs web<\/p>\n
And make sure you get the result as following.<\/p>\n
![\"Configure](\"https:\/\/afaghhosting.net\/blog\/wp-content\/uploads\/2018\/02\/how-to-install-gogs-go-git-service-on-ubuntu-16-04-6.png\" "\\"\\"")
<\/a><\/p>\nGogs is now running with our custom configuration, under ‘localhost’ with port 3000.<\/p>\n
Step 6 – Running Gogs as a Service<\/h2>\n
In this step, we will configure Gogs as a service on Ubuntu system. We will create a new service file configuration ‘gogs.service’ under the ‘\/etc\/systemd\/system’ directory.<\/p>\n
Go to the ‘\/etc\/systemd\/system’ directory and create a new service file ‘gogs.service’ using the\u00a0vim<\/a> editor.<\/p>\n
cd \/etc\/systemd\/system
vim gogs.service<\/p>\nPaste the following gogs service configuration there.<\/p>\n
[Unit]
[Service]
[Install]
Save and exit.<\/p>\n
Now reload the systemd services.<\/p>\n
systemctl daemon-reload<\/p>\n
Start gogs service and enable it to launch everytime at system boot using the systemctl command.<\/p>\n
systemctl start gogs
systemctl enable gogs<\/p>\n![\"Run](\"https:\/\/afaghhosting.net\/blog\/wp-content\/uploads\/2018\/02\/how-to-install-gogs-go-git-service-on-ubuntu-16-04-7.png\" "\\"\\"")
<\/a><\/p>\nGogs is now running as a service on Ubuntu system.<\/p>\n
Check it using the commands below.<\/p>\n
netstat -plntu
systemctl status gogs<\/p>\nAnd you should get the result as shown below.<\/p>\n
![\"Gogs](\"https:\/\/afaghhosting.net\/blog\/wp-content\/uploads\/2018\/02\/how-to-install-gogs-go-git-service-on-ubuntu-16-04-8.png\" "\\"\\"")
<\/a><\/p>\nStep 7 – Configure Nginx as a Reverse Proxy for Gogs<\/h2>\n
In this step, we will configure Nginx as a reverse proxy for Gogs. We will be using Nginx packages from its own repository.<\/p>\n
Add Nginx repository using the add-apt command.<\/p>\n
sudo add-apt-repository -y ppa:nginx\/stable<\/p>\n
Now update all Ubuntu repositories and install Nginx using the apt command below.<\/p>\n
sudo apt update
sudo apt install nginx -y<\/p>\nNext, goto the ‘\/etc\/nginx\/sites-available’ directory and create new virtual host file ‘gogs’.<\/p>\n
cd \/etc\/nginx\/sites-available
vim gogs<\/p>\nPaste the following configuration there.<\/p>\n
server {\u00a0\u00a0\u00a0 location \/ {
Save and exit.<\/p>\n
Note:<\/strong><\/p>\n
Change the ‘server_name’ line with your own domain name.<\/p>\n
Now activate a new virtual host and test the nginx configuration.<\/p>\n
ln -s \/etc\/nginx\/sites-available\/gogs \/etc\/nginx\/sites-enabled\/
nginx -t<\/p>\nMake sure there is no error, then restart the Nginx service.<\/p>\n
systemctl restart nginx<\/p>\n
![\"Nginx](\"https:\/\/afaghhosting.net\/blog\/wp-content\/uploads\/2018\/02\/how-to-install-gogs-go-git-service-on-ubuntu-16-04-9.png\" "\\"\\"")
<\/a><\/p>\nStep 8 – Testing<\/h2>\n
Open your web browser and type your gogs URL, mine is\u00a0http:\/\/git.hakase-labs.co<\/p>\n
Now you will get the installation page. On top of the page, type all of your PostgreSQL database info.<\/p>\n
![\"Gogs](\"https:\/\/afaghhosting.net\/blog\/wp-content\/uploads\/2018\/02\/how-to-install-gogs-go-git-service-on-ubuntu-16-04-10.png\" "\\"\\"")
<\/a><\/p>\nNow scroll to the bottom, and click the ‘Admin account settings’ dropdown.<\/p>\n
Type your admin user, password, and email.<\/p>\n
![\"Type](\"https:\/\/afaghhosting.net\/blog\/wp-content\/uploads\/2018\/02\/how-to-install-gogs-go-git-service-on-ubuntu-16-04-11.png\" "\\"\\"")
<\/a><\/p>\nThen click the ‘Install Gogs’ button.<\/p>\n
And you will be redirected to the Gogs user Dashboard as shown below.<\/p>\n
![\"Create](\"https:\/\/www.howtoforge.com\/images\/how_to_install_gogs_go_git_service_on_ubuntu_1604\/big\/1.png\" "\\"\\"")
<\/a><\/p>\n