How to Install Gibbon on Pop!_OS

Gibbon is an open-source educational management system for schools, colleges, and universities. In this tutorial, we will show you how to install Gibbon on Pop!_OS, a Linux-based operating system.

Before proceeding with the installation, you need to have some prerequisite packages installed on your system.

Prerequisites

If you don't have these packages already installed, you can use the following command to install them:

sudo apt-get update
sudo apt-get install apache2 mysql-server php composer

Step 1 - Downloading Gibbon

You can download the latest Gibbon release from the official website here. You can either download the archive (zip/tar.gz) or clone the repository from GitHub.

In this tutorial, we will be downloading the zip archive.

wget https://github.com/GibbonEdu/core/archive/master.zip

Step 2 - Extracting the Archive

Once downloaded, extract the archive in your web server directory. You can simply use the following command to extract the zip archive:

sudo unzip master.zip -d /var/www/html/

Step 3 - Setting Permissions

To ensure that Apache can read and write to the files in the Gibbon directory, we need to update the ownership and permissions of the directory.

You can use the following command to change the owner of the Gibbon directory to www-data:

sudo chown -R www-data: /var/www/html/core-master/

Step 4 - Installing Dependencies

Next, we need to install the dependencies required by Gibbon. To do this, navigate to the core-master directory and execute the following command:

cd /var/www/html/core-master/
sudo composer install

This command will install all the required dependencies for Gibbon.

Step 5 - Setting up the Database

Before we can use Gibbon, we need to create a database and a database user.

To create a new database, log in to the MySQL shell:

mysql -u root -p

Once you're logged in, create a new database:

mysql> CREATE DATABASE gibbon;

Create a new user and grant them full access to the database:

mysql> GRANT ALL PRIVILEGES ON gibbon.* TO 'gibbon'@'localhost' IDENTIFIED BY 'password';

Replace password with a secure password of your choice.

Exit the MySQL shell:

mysql> exit

Step 6 - Setting up Gibbon

Now we need to configure Gibbon for use. To do this, navigate to the config directory:

cd /var/www/html/core-master/config/

Copy the config_default.php to config.php:

sudo cp config_default.php config.php

Edit the config.php file:

sudo nano config.php

Update the following settings to reflect the database and user that you created in Step 5:

/**
 * DATABASE SETTINGS
 * The following are the settings for your database, these are required.
 *
 * dbName = your database name
 * dbUser = your database username
 * dbPass = your database password
 * dbHost = your database host, usually localhost
 */

    $gibbonSchoolDB['dbHost'] = 'localhost';
    $gibbonSchoolDB['dbUser'] = 'gibbon';
    $gibbonSchoolDB['dbPass'] = 'password';
    $gibbonSchoolDB['dbName'] = 'gibbon';

Save and close the file.

Step 7 - Finishing the Installation

Finally, we need to run the installer script to create the necessary database tables:

cd /var/www/html/core-master/install/
sudo php install.php

If everything went smoothly, you should now be able to access Gibbon by navigating to http://yourServerIP/core-master/ in your web browser.

Congratulations! You have successfully installed Gibbon on Pop!_OS.

If you want to self-host in an easy, hands free way, need an external IP address, or simply want your data in your own hands, give IPv6.rs a try!

Alternatively, for the best virtual desktop, try Shells!