{"id":513,"date":"2016-07-24T13:46:24","date_gmt":"2016-07-24T05:46:24","guid":{"rendered":"https:\/\/www.techcoil.com\/blog\/?p=513"},"modified":"2018-09-04T23:50:11","modified_gmt":"2018-09-04T15:50:11","slug":"setting-up-go-git-service-on-a-ubuntu-server-15-10-3-image-on-my-raspberry-pi-3","status":"publish","type":"post","link":"https:\/\/www.techcoil.com\/blog\/setting-up-go-git-service-on-a-ubuntu-server-15-10-3-image-on-my-raspberry-pi-3\/","title":{"rendered":"Setting up Go Git Service on a Ubuntu Server 15.10.3 image on my Raspberry Pi 3"},"content":{"rendered":"

My quest in searching for a suitable self hosted Git Service didn't stop at GitBucket. While GitBucket is easy to setup, running it on a Raspberry Pi 3<\/a> had not been ideal for me. If I had set it up on a more powerful computer \/ VM, I would have stuck with it.<\/p>\n

To get a second opinion, I decided to give Go Git Service a try. This post documents my attempt in setting up Go Git Service<\/a> on a Ubuntu 15.10.3 image on my Raspberry Pi 3. To make this post complete, the first eight steps are taken from previous posts.<\/p>\n

Getting the hardware<\/h2>\n

The hardware that I used for this setup is as follows:<\/p>\n

    \n
  1. A Raspberry Pi 3 motherboard<\/a><\/li>\n
  2. A PiBlox LEGO\u00ae Compatible Case<\/a><\/li>\n
  3. A SanDisk Ultra 32GB microSDHC UHS-I Card with Adapter<\/a><\/li>\n<\/ol>\n

    As my laptop came with a SD card reader, I did not have to get a SD card reader<\/a>. <\/p>\n

    Getting the Ubuntu Server 15.10.3 image for my Raspberry Pi 3 onto the micro SD card<\/h2>\n

    After I got the hardware that I needed, the next step was to get the Ubuntu Server 15.10.3 image for my Raspberry Pi 3. The awesome folks at Ubuntu Pi Flavour Maker<\/a> had made a few variations of Ubuntu images available for me to download<\/a>. <\/p>\n

    I downloaded a copy of the Ubuntu Server Standard 15.10.3 image onto my windows machine via torrent. <\/p>\n

    Once I got the .xz file, I used 7-zip<\/a> to extract the .img file. I then used Win32 Disk Imager to write the .img file<\/a> into the SanDisk microSD card<\/a> via the SD card drive on my laptop.<\/p>\n

    Booting into Ubuntu Server 15.10.3 on my Raspberry Pi 3<\/h2>\n

    Once Win32 Disk Imager completed writing the Ubuntu Server 15.10.3 image onto my SanDisk microSD card<\/a>, I removed it from my SD card reader and inserted it to the SD card slot on the Raspberry Pi 3 motherboard. Note that unlike the Raspberry Pi 2, the microSD slot of the Raspberry Pi 3 motherboard is not a spring loaded one.<\/strong> This means that you just push to insert your microSD card and pull to remove your microSD card.<\/p>\n

    I then attached my trusty mouse<\/a>, keyboard<\/a>, monitor<\/a>, a RJ45 network cable from my DLink router and my old samsung charger to my Raspberry Pi 3 motherboard. After turning on the power, the login screen appears. The default username is 'ubuntu' and the password is 'ubuntu'.<\/p>\n

    Adding a new user to access the server<\/h2>\n

    I do not like a default username for my web server, even though it is not going to be used as the production server. Hence, I first added a new user via the command as follows:<\/p>\n

    \r\nsudo adduser techcoil\r\n<\/pre>\n
    I then went through the following Q and As:<\/p>\n
    \r\nAdding user `techcoil' ...\r\nAdding new group `techcoil' (1000) ...\r\nAdding new user `techcoil' (1000) with group `techcoil' ...\r\nCreating home directory `\/home\/techcoil' ...\r\nCopying files from `\/etc\/skel' ...\r\nEnter new UNIX password: \r\nRetype new UNIX password: \r\npasswd: password updated successfully\r\nChanging the user information for techcoil\r\nEnter the new value, or press ENTER for the default\r\n\tFull Name []: Techcoil\r\n\tRoom Number []: #1234\r\n\tWork Phone []: 12345678\r\n\tHome Phone []: 12345678\r\n\tOther []: 12345678\r\n<\/pre>\n
    After I had created my new user account, I proceeded to add it to the sudo group so that I was able to continue with installing the necessary software:<\/p>\n
    \r\nsudo adduser techcoil sudo\r\n<\/pre>\n
    Deleting the default user<\/h2>\n
    Once I had created my user, I proceeded to delete the default user. <\/p>\n
    I first restarted the server:<\/p>\n
    \r\nsudo reboot\r\n<\/pre>\n
    After the server booted up again, I logged in with my new user.<\/p>\n
    Once I had logged into the server, I typed the following in the terminal to delete the default user:<\/p>\n
    \r\nsudo deluser --remove-home ubuntu\r\n<\/pre>\n
    Resizing the file system of my Ubuntu Server 15.10.3 image to utilize the entire microSD card space on my Raspberry Pi 3<\/h2>\n
    By default, the Ubuntu Server 15.10.3 image does not utilize the entire microSD card space on my Raspberry Pi 3.<\/p>\n
    Therefore, I proceeded on to resize the file system of my Ubuntu Server 15.10.3 image to utilize the entire microSD card space on my Raspberry Pi 3<\/a>.<\/p>\n
    Adding swap space to my Ubuntu Server 15.10.3 image<\/h2>\n
    1 GB of ram is not going to be enough to run Go Git Service alongside the other pieces that run the WordPress instance on my Raspberry Pi 3. As such, I also went on to add swap space to the Ubuntu Server 15.10.3 image<\/a> so as to complement the 1GB of ram on my Raspberry Pi 3.<\/p>\n
    Installing the MySQL database for Go Git Service<\/h2>\n
    Upon setting up the Ubuntu 15.10.3 image running on my Raspberry Pi, I proceeded to install the MySQL database server for my Go Git Service.<\/p>\n
    To do so, I typed the following in the terminal:<\/p>\n
    \r\nsudo apt-get install mysql-server mysql-client\r\n<\/pre>\n
    This led to the screen to enter a password for the root user:
    \n\"Password<\/p>\n
    And the screen to repeat the password for the root user:
    \n\"Password<\/p>\n
    I verified my MySQL database installation by entering the command:<\/p>\n
    \r\nsudo systemctl status mysql\r\n<\/pre>\n
    Which produced the following output:<\/p>\n
    \r\n\u25cf mysql.service - MySQL Community Server\r\n   Loaded: loaded (\/lib\/systemd\/system\/mysql.service; enabled; vendor preset: enabled)\r\n   Active: active (running) since Wed 2016-04-06 12:10:25 UTC; 15min ago\r\n Main PID: 4534 (mysqld_safe)\r\n   CGroup: \/system.slice\/mysql.service\r\n           \u251c\u25004534 \/bin\/sh \/usr\/bin\/mysqld_safe\r\n           \u2514\u25004881 \/usr\/sbin\/mysqld --basedir=\/usr --datadir=\/var\/lib\/mysql --...\r\n\r\nApr 06 12:10:23 ubuntu-standard systemd[1]: Starting MySQL Community Server...\r\nApr 06 12:10:24 ubuntu-standard mysqld_safe[4534]: 160406 12:10:24 mysqld_saf...\r\nApr 06 12:10:24 ubuntu-standard mysqld_safe[4534]: 160406 12:10:24 mysqld_saf...\r\nApr 06 12:10:24 ubuntu-standard mysqld_safe[4534]: 160406 12:10:24 mysqld_saf...\r\nApr 06 12:10:25 ubuntu-standard systemd[1]: Started MySQL Community Server.\r\nHint: Some lines were ellipsized, use -l to show in full.\r\n<\/pre>\n
    With that, I got myself a MySQL database server and a root account for the database related tasks later on. <\/p>\n
    Installing Git<\/h2>\n
    With the MySQL server running, the next item that I installed was Git<\/a>. To do so, I ran the following command in terminal:<\/p>\n
    \r\nsudo apt-get install git\r\n<\/pre>\n
    Downloading a copy of Go Git Service for Raspberry Pi 3<\/h2>\n
    After I had installed Git, I proceeded to download a copy of Go Git Service onto my Raspberry Pi 3: <\/p>\n
    \r\ncd \/opt\r\nsudo wget https:\/\/dl.gogs.io\/gogs_v0.9.141_raspi2.zip\r\nsudo unzip gogs_v0.9.141_raspi2.zip\r\nsudo rm gogs_v0.9.141_raspi2.zip\r\n<\/pre>\n
    This would result in the binary source of Go Git Service 0.9.141 to be available in \/opt\/gogs<\/code>.<\/p>\n
    Creating a database instance and a new MySQL user for Go Git Service<\/h2>\n
    Inside \/opt\/gogs\/scripts<\/code>, there is a helper script to aid in the creation of the MySQL database instance for Go Git Service. Hence, I used that script to create the database instance for my Go Git Service:<\/p>\n
    \r\nmysql -u root -p < \/opt\/gogs\/scripts\/mysql.sql\r\n<\/pre>\n
    This created an empty database instance named as gogs<\/code> in my MySQL server.<\/p>\n
    With the database instance created, I then proceeded to create a new MySQL user with privileges to interact with the gogs database instance.<\/p>\n
    I first got into the mysql shell:<\/p>\n
    \r\nmysql -u root -p\r\n<\/pre>\n
    Once inside the mysql shell, I ran the following commands:<\/p>\n
    \r\nmysql> CREATE USER 'gogsuser'@'localhost' IDENTIFIED BY 'password';\r\nmysql> GRANT ALL ON gogs.* TO 'gogsuser'@'localhost';\r\n<\/pre>\n
    These commands created a MySQL user with gogsuser<\/code> as the username and password<\/code> as the password. In addition, gogsuser<\/code> has the rights to act on the gogs<\/code> database instance.<\/p>\n
    Creating the system user that will run Go Git Service<\/h2>\n
    Once the database related configurations had been completed, I went on to create a system user that will run Go Git Service:<\/p>\n
    \r\nsudo adduser --disabled-login --gecos 'Go Git Service' gogs\r\n<\/pre>\n
    This would create a system user with username gogs<\/code> and Go Git Service as its descriptive name. In addition, this user cannot be used to login to Ubuntu Server<\/p>\n
    Making gogs the owner of \/opt\/gogs<\/h2>\n
    I then changed the owner of \/opt\/gogs<\/code> and its contents to gogs<\/code>:<\/p>\n
    \r\nsudo chown -R gogs:gogs gogs\r\n<\/pre>\n
    This would ensure that gogs<\/code> had the appropriate privileges to act on the items inside the \/opt\/gogs<\/code> folder.<\/p>\n
    Configuring Go Git Service to be run by systemctl<\/h2>\n
    To ensure that my Go Git Service is constantly up and running, I also configured my Go Git Service to run as a systemctl<\/code> service.<\/p>\n
    To do so, I first got into the \/opt\/gogs\/scripts\/systemd<\/code> folder:<\/p>\n
    \r\ncd \/opt\/gogs\/scripts\/systemd\r\n<\/pre>\n
    Inside this folder, there is a systemd<\/code> unit file, gogs.service<\/code>.<\/p>\n
    I first made a backup of this file:<\/p>\n
    \r\nsudo cp gogs.service gogs.service.bak\r\n<\/pre>\n
    I then opened up gogs.service<\/code> with nano<\/code>:<\/p>\n
    \r\nsudo nano gogs.service\r\n<\/pre>\n
    And changed the contents to resemble the following:<\/p>\n
    \r\n[Unit]\r\nDescription=Gogs (Go Git Service)\r\nAfter=syslog.target\r\nAfter=network.target\r\nAfter=mysql.service\r\n#After=postgresql.service\r\n#After=memcached.service\r\n#After=redis.service\r\n\r\n[Service]\r\n# Modify these two values and uncomment them if you have\r\n# repos with lots of files and get an HTTP error 500 because\r\n# of that\r\n###\r\n#LimitMEMLOCK=infinity\r\n#LimitNOFILE=65535\r\nType=simple\r\nUser=gogs\r\nGroup=gogs\r\nWorkingDirectory=\/home\/gogs\/systemdwd\r\nExecStart=\/opt\/gogs\/gogs web\r\nRestart=always\r\nEnvironment=USER=gogs HOME=\/home\/gogs\r\n\r\n[Install]\r\nWantedBy=multi-user.target\r\n<\/pre>\n
    After saving changes made to gogs.service, I created the \/home\/gogs\/systemdwd<\/code> folder to serve as the working directory for Go Git Service:<\/p>\n
    \r\nsudo -H -u gogs mkdir \/home\/gogs\/systemdwd\r\n<\/pre>\n
    After that, I enabled my Go Git Service so that it can be controlled by systemctl<\/code>:<\/p>\n
    \r\nsudo systemctl enable \/opt\/gogs\/scripts\/systemd\/gogs.service\r\n<\/pre>\n
    This would cause symbolic links to be created in the \/etc\/systemd\/system\/multi-user.target.wants<\/code> and \/etc\/systemd\/system<\/code> folders. These new symbolic links will link to \/opt\/gogs\/scripts\/systemd\/gogs.service.<\/p>\n
    I then started my Go Git Service with the following command:<\/p>\n
    \r\nsudo systemctl start gogs.service\r\n<\/pre>\n
    I then verified that Go Git Service runs successfully: <\/p>\n
    \r\nsudo systemctl status gogs.service\r\n<\/pre>\n
    which the following output:<\/p>\n
    \r\n\u25cf gogs.service - Gogs (Go Git Service)\r\n   Loaded: loaded (\/opt\/gogs\/scripts\/systemd\/gogs.service; enabled; vendor preset: enabled)\r\n   Active: active (running) since Sun 2016-07-24 13:39:59 SGT; 1s ago\r\n Main PID: 3930 (gogs)\r\n   CGroup: \/system.slice\/gogs.service\r\n           \u2514\u25003930 \/opt\/gogs\/gogs web\r\n\r\nJul 24 13:39:59 ubuntu-standard gogs[3930]: 2016\/07\/24 13:39:59 [I] Gogs: Go...8\r\nJul 24 13:39:59 ubuntu-standard gogs[3930]: 2016\/07\/24 13:39:59 [I] Log Mode...)\r\nJul 24 13:39:59 ubuntu-standard gogs[3930]: 2016\/07\/24 13:39:59 [I] Cache Se...d\r\nJul 24 13:39:59 ubuntu-standard gogs[3930]: 2016\/07\/24 13:39:59 [I] Session ...d\r\nJul 24 13:39:59 ubuntu-standard gogs[3930]: 2016\/07\/24 13:39:59 [I] Git Vers...0\r\nJul 24 13:39:59 ubuntu-standard gogs[3930]: 2016\/07\/24 13:39:59 [T] Doing: C...s\r\nJul 24 13:39:59 ubuntu-standard gogs[3930]: 2016\/07\/24 13:39:59 [I] SQLite3 ...d\r\nJul 24 13:39:59 ubuntu-standard gogs[3930]: 2016\/07\/24 13:39:59 [I] Run Mode...n\r\nJul 24 13:39:59 ubuntu-standard gogs[3930]: [mysql] 2016\/07\/24 13:39:59 stat...n\r\nJul 24 13:40:00 ubuntu-standard gogs[3930]: 2016\/07\/24 13:40:00 [I] Listen: ...0\r\nHint: Some lines were ellipsized, use -l to show in full.\r\n<\/pre>\n
    Starting the installation process<\/h2>\n
    Once the system related configurations are done, it was time to proceed on with the installation process.<\/p>\n
    To do so, I accessed my Go Git Service with my browser via http:\/\/192.168.0.200:3000<\/code>, where 192.168.0.200 is the ip address of my Raspberry Pi 3. This resulted in a web page that prompted for initial configurations.<\/p>\n
    I supplied the following values as my initial configurations:<\/p>\n
    \r\n======== Database Settings ========\r\nDatabase Type: MySQL\r\nHost: 127.0.0.1:3306\r\nUser: gogsuser\r\nPassword: password\r\nDatabase Name: gogs\r\n\r\n======== Application General Settings ========\r\nApplication Name: Gogs: Go Git Service\r\nRepository Root Path: \/home\/gogs\/gogs-repositories\r\nRun User: gogs\r\nDomain: 192.168.0.200\r\nSSH Port: 22\r\nHTTP Port: 3000\r\nApplication URL: http:\/\/192.168.0.200:3000\/\r\nLog Path: \/opt\/gogs\/log\r\n\r\n========  Admin Account Settings ======== \r\nUsername: admin\r\nPassword: password\r\nConfirm password: password\r\nAdmin Email: gogsAdmin@techcoil.com\r\n<\/pre>\n
    and clicked the Install Gogs<\/code> button. <\/p>\n
    Once the installation steps were completed, I was shown the following screen in my browser:<\/p>\n
    \"Go<\/p>\n
    With that, I got a relatively responsive self hosted Git Service running on my Raspberry Pi 3.<\/p>\n
    Buying the Raspberry Pi 3 hardware to host your own Go Git Service from Amazon<\/h2>\n
    If you do not have the Raspberry Pi 3 hardware mentioned in this post yet, you may want to purchase them from Amazon. Simply click on the button below to add the Raspberry Pi 3 hardware to your cart. You may remove anything that you already have or replace some of the hardware with other hardware.<\/p>\n
    <\/p>\n

    \n<\/form>\n
    <\/center><\/p>\n\n