Localhost Installation

This guide will walk you through installing Mentor LMS on your local development environment (Windows, macOS, or Linux).

Prerequisites

Before you begin, ensure you have the following installed:

• PHP (version 8.2 or higher)
• Composer (PHP dependency manager)
• Node.js and npm (for frontend assets)
• MySQL or MariaDB database server
• Web Server (Apache, Nginx, or PHP built-in server)

Installation Steps

Step 1: Extract the Package

1. Download the Mentor LMS package from CodeCanyon
2. Extract the ZIP file to your local development directory:
   • XAMPP: C:\xampp\htdocs\mentor-lms
   • Laragon: C:\laragon\www\mentor-lms
   • MAMP: /Applications/MAMP/htdocs/mentor-lms

Step 2: Create Database

1. Open phpMyAdmin (usually at http://localhost/phpmyadmin)
2. Click on Databases tab
3. Create a new database (e.g., mentor_lms)

Step 3: Install Dependencies

# Install PHP dependencies
composer install

# Install Node.js dependencies
npm install

Step 4: Database Migration & Seeding

After installing dependencies, prepare the database using one of these methods:

Option 1: Artisan Commands

1. Navigate to storage/app/public/ and create an empty file named installed (no extension)
2. Run the migration and seed commands:

php artisan migrate
php artisan db:seed

Or run both in one command:

php artisan migrate:refresh --seed

3. Create the storage symbolic link:

php artisan storage:link

4. Start the local development server:

composer dev

This starts the application at http://localhost:8000. You also need to compile assets:

npm run dev

Option 2: Web Installer

Start the development server:

composer dev

Then open your browser at http://localhost:8000 — you'll be redirected to the installation wizard automatically. Follow the Web Installer Guide.