Installation Guide
Shared Hosting Installation
How to install Mentor LMS on a shared hosting server using cPanel or Plesk.
This guide will help you install Mentor LMS on a shared hosting server (cPanel, Plesk, or similar environments).
Server Requirements
- PHP >= 8.2 (PHP 8.3 recommended)
- All required PHP extensions enabled (see Requirements)
symlink() Required
The symlink() function must be enabled. Contact your hosting provider if you're unsure.
Installation Steps
Step 1: Create Database
- Log in to your cPanel or hosting control panel
- Navigate to MySQL Databases
- Create a new database and note the credentials:
- Database name
- Database username
- Database password
Step 2: Upload Files
- Log in to cPanel and open File Manager
- Navigate to
public_html(or your domain's root directory) - Upload the Mentor LMS ZIP file
- Select the ZIP file and click Extract
- Rename
.env.exampleto.env
Step 3: Access Web Installer
- Open your browser and navigate to
https://your-domain.com - You will be automatically redirected to the installation wizard
- If not redirected, visit:
https://your-domain.com/install/step-1
Professional Installation
If the web installer doesn't work, follow the manual installation steps below.
Step 4 (Optional): Manual Installation
Edit the .env file
Update the database credentials:
APP_URL=https://your-domain.com
DB_DATABASE=your_database_name
DB_USERNAME=your_database_username
DB_PASSWORD=your_database_passwordCreate the installed flag
- Navigate to
storage/app/publicin File Manager - Create a new empty file named
installed(no extension need)
Import the database
- In cPanel, open phpMyAdmin
- Select your database from the sidebar
- Click Import → Choose file
- Select the
mentor-lms.sqlfile from your project - Click Go to import
Temporary Admin Login
After manual installation, log in with:
- Email:
admin@example.com - Password:
12345678
Security Note
Change these default credentials immediately after your first login.
Need Help?
If you encounter issues during installation, contact support at support@ui-lib.com.