Skip to main content

Installation on Windows (Local)

TadreebLMS can be installed on Windows for local development and testing using a bundled web server environment. This method is suitable for developers who want to run TadreebLMS on their local machine without setting up a full Linux server.

This guide uses XAMPP with PHP 8.2, which provides Apache, MySQL, and PHP in a single installer.

Supported Environment​

  • Windows 10 or later
  • XAMPP (with PHP 8.2)
  • Apache Web Server
  • MySQL Database
  • PHP 8.2
  • Composer 2.7.8

Install XAMPP (PHP 8.2)​

Download XAMPP for Windows with PHP 8.2 from:

https://www.apachefriends.org

Install XAMPP to the default location:

C:\xampp

Start Apache and MySQL​

Open the XAMPP Control Panel and start:

  • Apache
  • MySQL

Ensure both services are running without errors.

Verify PHP Version​

Open a terminal (Command Prompt or PowerShell) and run:

php -v

Ensure the output shows:

PHP 8.2.x

Clone TadreebLMS​

Navigate to the XAMPP web root:

cd C:\xampp\htdocs

Clone the TadreebLMS repository:

git clone https://github.com/Tadreeb-LMS/tadreeblms.git

Create Database​

Open phpMyAdmin in your browser:

http://localhost/phpmyadmin

Create a new database named:

laravel_db

The database tables will be created automatically during the installer process.

Verify Composer​

Ensure Composer is installed and available:

composer --version

The output should show:

Composer version 2.7.8

Run Web Installer​

Open the TadreebLMS installer in your browser:

http://localhost/tadreeblms/public

Follow the on-screen onboarding process to configure the database, create the admin account, and complete setup.

The .env file is automatically generated during this process.

Access Application​

After installation is complete, access TadreebLMS at:

http://localhost/tadreeblms/public

Log in using the admin credentials created during onboarding.

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