Trying to install Gogs on Ubuntu 16.04 - A journey
Trying to install Gogs on an Ubuntu server is not as easy as it seems if all the conditions are not peacy perfect. I wen through the hoops, and I documented them here hoping that you will find it easier to jump through them instead of having to find several parts of answers scattered around the internet like I had.
So my current stats: Ubuntu 16.04, MariaDB 10.0, Nginx something
First off:
Upgrading your Maria db.
How to do that is copied from https://websiteforstudents.com/upgrading-mariadb-from-10-0-to-10-1-to-10-2-on-ubuntu-16-04-17-10/ but copied here in case it goes down/vanishes etc.. like stuff on the internet likes to do, but do visit that site, it has tons of useful information.
This is assuming you have a mariadb installation already present at a lower version than 10.2, if you don't have it yet just skip to the 10.2 step.
First off log onto your database.
Ubuntu 16.04
Now remove the Maria DB server from your system.
Then try to run the upgrade command again
We needed this upgrade because otherwise there are going to be problems with database keys being too big and you getting an error like
Now to install Gogs.
I chose to install via packages, you can decide another method but then you're on your own unfortunately.
According to the installation page https://gogs.io/docs/installation/install_from_packages they supply their packages via packager.io which leads us to this wonderful overview https://packager.io/gh/pkgr/gogs
There I clicked on the Ubuntu 16.04 icon of the most recent package to get to the installation instructions
https://packager.io/gh/pkgr/gogs/builds/687/install/ubuntu-16.04
After this warm up let's try to party and actually start setting things up.
Setting up the database
We need a database set up for Gogs, so lets set up a user and database for it.
Being able to see Gogs
Now we need to have access to Gogs. Default Gogs will run it's configure server on port 6000. Default this will be blocked by Chrome and Firefox with ERR_UNSAFE_PORT.
We can't access Gogs yet to put in our database credentials. Unless you're fine working with internet explorer. That'll work with port 6000 just fine and dandy, or you wish to fiddle with your chrome settings to allow port 6000, but you'll have to remember to do that with every chrome you'll work with.
Up to nginx configuration:
Now we need to make a symlink to sites enabled
If you can't see it or you get a connection refused, you might need to whitelist port 8080 in your firewall:
And that's how it's made "easy" to set up Gogs :-)
So my current stats: Ubuntu 16.04, MariaDB 10.0, Nginx something
First off:
Upgrading your Maria db.
How to do that is copied from https://websiteforstudents.com/upgrading-mariadb-from-10-0-to-10-1-to-10-2-on-ubuntu-16-04-17-10/ but copied here in case it goes down/vanishes etc.. like stuff on the internet likes to do, but do visit that site, it has tons of useful information.
This is assuming you have a mariadb installation already present at a lower version than 10.2, if you don't have it yet just skip to the 10.2 step.
First off log onto your database.
sudo mysql -u root -p
Run the following command
mysql> SET GLOBAL innodb_fast_shutdown = 0;
Make a backup of your databases if needed to be then stop the mysql serviceUbuntu 16.04
sudo systemctl stop mysql.service
On Ubuntu 17.10 and up, run the command below:
sudo systemctl stop mariadb.serviceNow remove the Maria DB server from your system.
sudo apt remove mariadb-server
In stall the software properties and the keys.sudo apt-get install software-properties-common sudo apt-key adv --recv-keys --keyserver hkp://keyserver.ubuntu.com:80 0xF1656F24C74CD1D8Now we do the upgrade shuffle. I read in several places it was best to do the upgrade in steps to keep database integrity, so first upgrading to 10.1 and then then 10.2. If you like to live dangerously upgrade right away to 10.2.
sudo sh -c "echo 'deb [arch=amd64,i386] https://mirrors.evowise.com/mariadb/repo/10.1/ubuntu '$(lsb_release -cs)' main' > /etc/apt/sources.list.d/MariaDB-10.1.list" sudo apt-get update sudo apt-get install mariadb-serverNow to upgrade your databases to 10.1
sudo mysql_upgradeIf you happen to get the below error message:
ERROR 1524 (HY000): Plugin 'unix_socket' is not loaded FATAL ERROR: Upgrade failedYou will need to follow the steps as laid out on https://websiteforstudents.com/fix-mariadb-plugin-unix_socket-is-not-loaded-error-on-ubuntu-17-04-17-10/
sudo nano /etc/mysql/mariadb.conf.d/50-server.cnf
Then add the line below right below the [mysqld] marker.plugin-load-add = auth_socket.so
After adding the line into the file, run the commands below to restart Maria DB
sudo systemctl restart mariadb.service
Then try to run the upgrade command again
sudo mysql_upgradeWhen the upgrade command has completed we are going to do the tricks again to upgrade to 10.2
sudo systemctl stop mysql.service
sudo apt remove mariadb-server
sudo sh -c "echo 'deb [arch=amd64,i386] https://mirrors.evowise.com/mariadb/repo/10.2/ubuntu '$(lsb_release -cs)' main' > /etc/apt/sources.list.d/MariaDB-10.2.list"
sudo apt-get update
sudo apt-get install mariadb-server mariadb-client
sudo systemctl restart mariadb.service
sudo mysql_upgrade
And now we have a Maria DB upgrade complete.We needed this upgrade because otherwise there are going to be problems with database keys being too big and you getting an error like
Error 1071: Specified key was too long; max key length is 767 bytes
or like
Error 1071: Specified key was too long; max key length is 1000 bytesBut when we're at Mariadb 10.2 we're good to go, that error doesn't happen.Now to install Gogs.
I chose to install via packages, you can decide another method but then you're on your own unfortunately.
According to the installation page https://gogs.io/docs/installation/install_from_packages they supply their packages via packager.io which leads us to this wonderful overview https://packager.io/gh/pkgr/gogs
There I clicked on the Ubuntu 16.04 icon of the most recent package to get to the installation instructions
https://packager.io/gh/pkgr/gogs/builds/687/install/ubuntu-16.04
wget -qO- https://dl.packager.io/srv/pkgr/gogs/key | sudo apt-key add -
sudo wget -O /etc/apt/sources.list.d/gogs.list \
https://dl.packager.io/srv/pkgr/gogs/pkgr/installer/ubuntu/16.04.repo
sudo apt-get update
sudo apt-get install gogsIf for some reason it doesn't run on the first try you'll might have to run this command first.apt-get install wget apt-transport-https
We have Gogs now, we have an upgraded Maria DB, we already had an Nginx. After this warm up let's try to party and actually start setting things up.
Setting up the database
We need a database set up for Gogs, so lets set up a user and database for it.
mysql -uroot -p
create database gogs;
create user gogs;
grant privileges on gogs.* to `gogs`@`localhost` identified by 'a_fancy_password_here';
exit
Being able to see Gogs
Now we need to have access to Gogs. Default Gogs will run it's configure server on port 6000. Default this will be blocked by Chrome and Firefox with ERR_UNSAFE_PORT.
We can't access Gogs yet to put in our database credentials. Unless you're fine working with internet explorer. That'll work with port 6000 just fine and dandy, or you wish to fiddle with your chrome settings to allow port 6000, but you'll have to remember to do that with every chrome you'll work with.
Up to nginx configuration:
cd /etc/nginx/sites-available
sudo nano gogs
And insert there the following code(I chose port 8080 since it's whitelisted by chrome and I have other things running on 80, but do as you please):
server {
listen 8080;
server_name your_server_name_here;
location / {
proxy_pass http://localhost:6000;
}
}
Press CTRL + X to exit and answer yes on the question if you wish to save.Now we need to make a symlink to sites enabled
sudo ln -s /etc/nginx/sites-available/gogs /etc/nginx/sites-enabled/gogs
Now to restart Nginx to have our server up and running
sudo service nginx restart
Now browse to your website at http://your-domain:8080 and you should see all the configuration settings you can enter for Gogs.If you can't see it or you get a connection refused, you might need to whitelist port 8080 in your firewall:
ufw allow 8080/tcpAnd that's how it's made "easy" to set up Gogs :-)
Comments
Post a Comment