Tadreeb LMS Installation Guide

Ubuntu Server

Installation Guide This guide explains how to install TadreebLMS on a fresh Ubuntu server.

Recommended OS: Ubuntu 20.04 / 22.04 Web Server: Apache 2.x PHP Version: 8.3 Composer Version: 2.7.8

1. Update Server

sudo apt update && sudo apt upgrade -y

2. Install Apache

sudo apt install apache2 -y
sudo systemctl enable apache2
sudo systemctl start apache2

3. Install PHP 8.3

sudo apt install software-properties-common -y
sudo add-apt-repository ppa:ondrej/php -y
sudo apt update
sudo apt install php8.3 php8.3-cli php8.3-common php8.3-mbstring php8.3-xml php8.3-curl php8.3-zip php8.3-mysql php8.3-bcmath php8.3-gd php8.3-ldap -y

4. Install Composer

cd /tmp
php -r "copy('https://getcomposer.org/installer', 'composer-setup.php');"
php composer-setup.php --version=2.7.8
sudo mv composer.phar /usr/local/bin/composer
composer --version

5. Clone TadreebLMS

cd /var/www
sudo git clone https://github.com/Tadreeb-LMS/tadreeblms.git
sudo chown -R www-data:www-data /var/www/tadreeblms
cd tadreeblms

6. Setup Storage & Cache

sudo mkdir -p bootstrap/cache
sudo mkdir -p storage/framework/views storage/framework/cache/data storage/framework/sessions storage/logs
sudo chown -R www-data:www-data storage bootstrap/cache public
sudo chmod -R 775 storage bootstrap/cache public

7. Install & Configure MySQL

sudo apt install mysql-server -y
sudo mysql
CREATE DATABASE laravel_db;
CREATE USER 'laravel'@'localhost' IDENTIFIED BY 'password';
GRANT ALL PRIVILEGES ON laravel_db.* TO 'laravel'@'localhost';
FLUSH PRIVILEGES;
EXIT;

Update .env with database credentials.

8. Apache Virtual Host

sudo nano /etc/apache2/sites-available/tadreeblms.conf

<VirtualHost *:80>
    ServerName YOUR_DOMAIN
    DocumentRoot /var/www/tadreeblms/public

    <Directory /var/www/tadreeblms/public>
        AllowOverride All
        Require all granted
    </Directory>

    ErrorLog ${APACHE_LOG_DIR}/tadreeblms_error.log
    CustomLog ${APACHE_LOG_DIR}/tadreeblms_access.log combined
</VirtualHost>

sudo a2enmod rewrite
sudo a2ensite tadreeblms.conf
sudo systemctl reload apache2

9. Access Application

Open in browser:

http://YOUR_DOMAIN

Complete the web-based onboarding to finish setup.

10. Install Google Chrome for Certificate Generation

TadreebLMS certificate generation requires a server-side browser to render certificate PDFs.
Install Google Chrome on the server and configure the Chrome binary path in the .env file.

Install Google Chrome

cd /tmp
wget https://dl.google.com/linux/direct/google-chrome-stable_current_amd64.deb
sudo apt install -y ./google-chrome-stable_current_amd64.deb

If dependency issues occur, run:

sudo apt --fix-broken install -y
sudo apt install -y ./google-chrome-stable_current_amd64.deb

Verify Installation

which google-chrome
google-chrome --version

Expected output:

/usr/bin/google-chrome
Google Chrome <version>

Configure Chrome Path in .env

Add the following lines to the TadreebLMS .env file:

CHROME_BIN=/usr/bin/google-chrome
CHROMIUM_PATH=/usr/bin/google-chrome

Clear Laravel Configuration Cache

After updating .env, run:

cd /var/www/tadreeblms
sudo -u www-data php artisan config:clear
sudo -u www-data php artisan cache:clear
sudo -u www-data php artisan config:cache

Email Configuration

Email Configuration Required

Tadreeb LMS uses email services for:

• User notifications
• Course notifications
• Password resets
• System alerts
• Queue-based email jobs

To configure SMTP and email settings, follow the dedicated guide:

👉 Email Configuration

⚠️ Emails will not be sent unless SMTP is properly configured.