How to Install Gibbon on macOS

Gibbon is a free and open-source web-based school management system that provides a platform for teachers, students, and parents to interact and manage educational activities. In this tutorial, you will learn how to install Gibbon on macOS.

Prerequisites

Before you start with the installation of Gibbon, you need to ensure that you have the following prerequisites installed on your macOS:

  • PHP
  • MySQL/MariaDB
  • Apache/Nginx

Step 1: Download Gibbon

Visit the Gibbon website https://gibbonedu.org/ and click the green "Download" button. You will get an option to choose from the two available options: Get Gibbon Open Source and Buy Gibbon. Choose "Get Gibbon Open Source" and Gibbon will begin downloading.

Step 2: Unzip the File

Once the download is complete, go to the "Downloads" folder on your macOS and find the Gibbon zip file that you just downloaded. Double-click on the zip file to extract it.

Step 3: Move Gibbon to Web Server

In the extracted folder, you will find a folder named "gibbon". Move this folder to a location on your web server where it can be accessed by your web server. Typically, this folder should be located in your web server's document root directory.

Step 4: Configure Database Settings

Open the "gibbon" folder and locate the file named ".env.example". Rename this file to ".env". Now, open the ".env" file in a text editor and set the following configuration values:

  • DB_HOST: the hostname of your MySQL/MariaDB server
  • DB_PORT: the port number of your MySQL/MariaDB server (usually 3306)
  • DB_DATABASE: the name of the Gibbon database you want to use
  • DB_USERNAME: the username with which you want to connect to your MySQL/MariaDB server
  • DB_PASSWORD: the password for the above MySQL/MariaDB username

Save the ".env" file.

Step 5: Set Permissions

To ensure proper functioning, you need to set permissions for the "gibbon" folder. In Terminal, navigate to the "gibbon" folder and execute the following command:

sudo chmod -R 755 storage bootstrap

Step 6: Access Gibbon

You can now access Gibbon by visiting http://localhost/gibbon (replace "localhost" with your server's domain name or IP address, if necessary) in your web browser. You will be asked to create a new admin account.

Congratulations! You have successfully installed Gibbon on your macOS.