Skip to main content

TadreebLMS — macOS Local Setup

This guide explains how to set up TadreebLMS on macOS using Homebrew (PHP 8.3).
It follows a strict step-by-step sequence and includes common macOS fixes.

Step 1: Install Homebrew​

Run:

/bin/bash -c "$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/HEAD/install.sh)"

Verify:

brew --version

Step 2: Install Apache​

brew install httpd
brew services start httpd

Enable rewrite module:

nano $(brew --prefix)/etc/httpd/httpd.conf

Uncomment:

LoadModule rewrite_module lib/httpd/modules/mod_rewrite.so

Restart Apache:

brew services restart httpd

Step 3: Install PHP 8.3​

brew install php@8.3
php -v

Step 4: Install Composer​

brew install composer
composer --version

Restart terminal after installation.

Step 5: Clone TadreebLMS​

mkdir -p ~/Sites
cd ~/Sites
git clone https://github.com/Tadreeb-LMS/tadreeblms.git
cd tadreeblms

Step 6: Verify Composer​

composer --version

Expected:

Composer version 2.7.8+

Step 7: Create Database​

brew install mysql
brew services start mysql
mysql -u root
CREATE DATABASE laravel_db;
EXIT;

Step 8: Create Sessions Directory​

Ensure directory exists:

storage/framework/sessions

Create manually if missing:

mkdir -p storage/framework/sessions

Step 9: Apache Virtual Host​

nano $(brew --prefix)/etc/httpd/httpd.conf

Add:

<VirtualHost *:80>
    ServerName tadreeblms.local
    DocumentRoot /Users/YOUR_USERNAME/Sites/tadreeblms/public

    <Directory /Users/YOUR_USERNAME/Sites/tadreeblms/public>
        AllowOverride All
        Require all granted
    </Directory>
</VirtualHost>

Add hosts entry:

sudo nano /etc/hosts
127.0.0.1 tadreeblms.local

Restart Apache:

brew services restart httpd

Step 10: Run Web Installer​

Open:

http://tadreeblms.local

Use database credentials:

Host     : 127.0.0.1
Database : laravel_db
Username : root
Password : (empty)

Step 11: Access Application​

Always use:

http://tadreeblms.local

Notes​

  • macOS 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
  • Recommended Composer version: 2.7.8+
  • The .env file is automatically generated during installation
  • Installation is complete once the TadreebLMS login page loads successfully