Mighty-School Installation Process

Complete step-by-step guide to install your Mighty School Management System on cPanel shared hosting. Follow these simple steps to get your school management system up and running.

Simple cPanel Installation

This guide will walk you through the complete installation process from uploading files to final testing. Each step includes detailed instructions and screenshots.

1

Uploading the Project Files to cPanel

Step 1: Log into cPanel

Open your web browser and navigate to your cPanel login page. Usually, it is:

Enter your username and password to log in.

2

Setting Up the Database

Step 2: Create a Database in cPanel

  1. Go back to the cPanel Dashboard and scroll to the Databases section.
  2. Click on MySQL Databases.
  3. Under Create a New Database, provide a name for your database, e.g., mighty_school_db.
  4. Click Create Database.

Step 3: Create a MySQL User

  1. Under the MySQL Users section, create a new MySQL user by entering a username and password.
  2. Click Create User.
  3. After creating the user, add them to the newly created database:
  4. Under Add User to Database, select the user and database you just created.
  5. Check All Privileges and click Make Changes.
4

Create a sub-domain for php backend api

Step 4: Create a domain in cPanel

Go back to the cPanel Dashboard and scroll to the Domain section.

5

Upload backend php file and extract in cpanel domain folder

Step 5: Upload file

Go back to the cPanel Dashboard and scroll to the Domain under folder section.

6

Run the website and the installation process starts

Step 6: Installation process

Navigate to your domain in the browser to start the automatic installation process.

7

Set Up File Permissions

Step 7: Set Correct Permissions for Laravel Files

Laravel requires specific folder permissions to function correctly. Set the following folder permissions via File Manager or SSH if you have access:

storage/ and bootstrap/cache/ should be writable by the web server (usually 755 or 775 permissions).

chmod -R 775 storage bootstrap/cache
8

Set Up Cron Jobs (Optional)

Step 8: Configure Cron Jobs for Laravel Scheduler

If the Laravel application requires scheduled tasks (like daily reports, emails, etc.), you'll need to set up a cron job.

  1. In cPanel, go to Cron Jobs under the Advanced section.
  2. Add a new cron job to run Laravel's scheduler every minute:
* * * * * php /home/username/public_html/mighty-school/artisan schedule:run >> /dev/null 2>&1
9

Test the Installation

Step 9: Final Testing

  1. Open your browser and go to your domain (e.g., http://yourdomain.com).
  2. Ensure the application is up and running.

Troubleshooting

Issue 1: Laravel not loading properly

Ensure storage and bootstrap/cache directories are writable.

Issue 2: Database connection errors

Double-check your .env file, and make sure the database credentials and hostname are correct.

Congratulations!

Your Mighty-School Laravel project should now be installed successfully on your cPanel hosting environment.

Installation Completion Checklist

What's Next?

With your Mighty-School backend successfully installed, you can now proceed to configure your Flutter mobile applications and admin panel.