v5.0.0 Upgrade Guide
Manual upgrade guide for moving to MentorLMS v5 modular structure.
Website Update of MentorLMS v5.0.0
We have introduced a new coding structure for the application called the Modular Structure from the v5.0.0.
Benefits of the Modular Structure
-
📦 Reduced Application Size
- Decreased from ~90MB to around ~60MB
-
⚡ Improved Performance
- Faster loading and better overall efficiency
-
🛠️ Easier Maintenance
- Makes it easier to manage and update the source code
Important — Manual Upgrade Required for This Version first time
Due to the migration to the new Modular Structure, you must follow this manual upgrade guide for the first time use of v5 or higher.
Previously, version updates could be performed easily and automatically from the App Maintenance Page. However, because of the new code structure, the automatic version update process from the Maintenance Page will not work for this update.
Please do NOT use the automatic update option from the Maintenance Page for this version.
Once this manual upgrade is complete, future version updates will again be available directly from the App Maintenance Page.
Step 1: Access Your Server
- Log in to your hosting panel (cPanel) or your server (SSH).
- Navigate to the directory where your project is installed.
Step 2: Create a Full Backup (Very Important)
Before making any changes:
- Create a new folder (e.g.,
backup) - Copy all existing project files into this folder
✅ This ensures you can restore your website if anything goes wrong.
Step 3: Upload the Latest Version v5.x
- Upload the latest version source code
.zipfile into your project root directory.
Step 4: Clean Old Files
Delete all existing files and folders EXCEPT the following:
.env(important configuration file)public(contains public assets)storage(contains logs, cache, uploads)backup(contain the last version backup)- Uploaded latest version
.zipfile
⚠️ Do NOT delete these important files and folders.
Step 5: Extract New Source Code
- Extract the uploaded latest version
.zipfile. - This will replace your old source code with the updated version.
Step 6: Reload Your Application
- Open your website in a browser.
- You have to go to the Maintenance Page.
Step 7: Complete the Update
From the Maintenance Page:
- Run the database seeder
- Execute any required update or migration steps
Wait until the process completes.
Update Completed!
Your application is now fully updated and ready to use.
Future Updates
With the new modular system, future updates will be easier and more efficient.
You will be able to update your website directly from the Maintenance Page.
Video Tutorial
Need Help?
If you face any issues during the update process, feel free to contact support at support@ui-lib.com.