Skip to main content

TadreebLMS - Windows Local Setup

This guide explains how to set up TadreebLMS on Windows using XAMPP. It follows a strict step-by-step sequence and includes fixes for common Windows/XAMPP issues.

Important: Apache Friends currently provides XAMPP for Windows with PHP 8.2.x on the main download page.
TadreebLMS supports PHP 8.2.x and this is the recommended Windows setup.

Step 1: Install XAMPP​

Download XAMPP for Windows from:
https://www.apachefriends.org

Install to:

C:\xampp

Start Apache and MySQL from XAMPP Control Panel.

phpMyAdmin is included with XAMPP by default.

Open:

http://localhost/phpmyadmin

Step 2: Install Composer (Ignore if already installed)​

Check first:

composer --version

If Composer is not installed, download from:

https://getcomposer.org/download/

Run Composer-Setup.exe

When prompted for PHP path, select:

C:\xampp\php\php.exe

Restart terminal after installation.

Step 3: Add PHP to System PATH (Ignore if already configured)​

Add the following to System PATH:

C:\xampp\php

Restart terminal.

Verify:

php -v

Step 4: Install Git (Ignore if already installed)​

Download:

https://git-scm.com/download/win

Verify:

git --version

Step 5: Enable Required PHP Extensions (Important)​

Edit:

C:\xampp\php\php.ini

Enable these lines (remove ; if present):

extension=gd
extension=zip
extension=ldap
extension=sodium

Restart Apache from XAMPP Control Panel.

Verify:

php -m

Step 6: Clone TadreebLMS​

cd C:\xampp\htdocs
git clone https://github.com/Tadreeb-LMS/tadreeblms.git

Step 7: Create Database​

Open:

http://localhost/phpmyadmin

Create database:

tadreeblms

Step 8: Run Web Installer​

Open:

http://localhost/tadreeblms/public

Use database credentials:

Host     : 127.0.0.1
Port     : 3306
Database : tadreeblms
Username : root
Password : (empty)

Step 9: Access Application​

Always use:

http://localhost/tadreeblms/public

Installation is complete once the TadreebLMS login page loads successfully.

Troubleshooting​

PHP CLI not found​

Ensure:

C:\xampp\php

is added to PATH.

Restart terminal.

Composer command not found​

Install Composer and select:

C:\xampp\php\php.exe

Git command not found​

Install Git for Windows.

Dependencies not installed / vendor folder missing​

cd C:\xampp\htdocs\tadreeblms
composer install

JSON Syntax Error (Unexpected token less-than)​

Cause: Installer AJAX expected JSON but received HTML.

Fix:

  • Refresh page once
  • Open browser Developer Tools
  • Inspect failed Network request
  • Check:
storage\logs\laravel.log

Database access denied​

Use:

Username : root
Password : (empty)

Ensure database exists.

GD / ZIP / LDAP / Sodium extension missing​

Edit:

C:\xampp\php\php.ini

Enable:

extension=gd
extension=zip
extension=ldap
extension=sodium

Restart Apache.

MySQL shutdown unexpectedly​

Check port conflict:

netstat -ano | findstr :3306

Stop other MySQL services from:

services.msc

Seeder failed / duplicate function error​

Update project:

git pull

If issue persists, inspect file mentioned in error.

Create Sessions Directory(Create manually if missing.)​

Ensure this directory exists:

storage\framework\sessions

Notes​

  • Windows installation is intended for local development only
  • For production deployments, use the Linux installation guide
  • Ensure Apache and MySQL are running before accessing the application
  • Composer 2.7+ recommended
  • .env file is generated during installation