#!/usr/bin/env bash # Build a clean cPanel / shared-hosting deploy ZIP (run from project root). set -euo pipefail ROOT="$(cd "$(dirname "$0")" && pwd)" VERSION="$(tr -d '[:space:]' < "$ROOT/VERSION")" OUT_DIR="$ROOT/dist" STAGE="$OUT_DIR/stage" NAME="Academy-LMS-v${VERSION}-cPanel" rm -rf "$STAGE" "$OUT_DIR/${NAME}.zip" mkdir -p "$STAGE/Documentation" "$STAGE/Main Files" # Admin how-to guide into Documentation mkdir -p "$ROOT/documentation" cp -f "$ROOT/static/docs/admin-guide.html" "$ROOT/documentation/admin-guide.html" 2>/dev/null || true # Docs cp -R "$ROOT/documentation/." "$STAGE/Documentation/" # Main files via rsync-like copy rsync -a \ --exclude 'venv' \ --exclude '.venv' \ --exclude '.env' \ --exclude 'dist' \ --exclude 'storage/installed' \ --exclude '__pycache__' \ --exclude '*.pyc' \ --exclude '.git' \ --exclude 'db.sqlite3' \ --exclude '*.sqlite3' \ --exclude '.DS_Store' \ --exclude '.cursor' \ --exclude 'logs/*.log' \ --exclude 'staticfiles' \ --exclude 'media/payment_proofs' \ --exclude 'media/profile_pictures' \ --exclude 'media/course_thumbnails' \ --exclude 'media/course_certificates' \ --exclude 'media/course_badges' \ --exclude 'media/practical_submissions' \ --exclude 'media/project_submissions' \ --exclude 'media/project_screenshots' \ --exclude 'media/module_pdfs' \ --exclude 'media/certificates' \ --exclude 'media/Logo/*' \ --exclude 'agent-transcripts' \ "$ROOT/" "$STAGE/Main Files/" # Keep Logo folder empty-ready mkdir -p "$STAGE/Main Files/media/Logo" touch "$STAGE/Main Files/media/Logo/.gitkeep" # Ensure empty storage (no lock) — fresh cPanel installs run /install/ mkdir -p "$STAGE/Main Files/storage" rm -f "$STAGE/Main Files/storage/installed" touch "$STAGE/Main Files/storage/.gitkeep" # Empty runtime dirs that must exist on upload mkdir -p "$STAGE/Main Files/logs" "$STAGE/Main Files/staticfiles" touch "$STAGE/Main Files/logs/.gitkeep" touch "$STAGE/Main Files/staticfiles/.gitkeep" # Ensure admin guide ships inside Main Files too mkdir -p "$STAGE/Main Files/static/docs" "$STAGE/Main Files/documentation" cp -f "$ROOT/static/docs/admin-guide.html" "$STAGE/Main Files/static/docs/admin-guide.html" cp -f "$ROOT/static/docs/admin-guide.html" "$STAGE/Main Files/documentation/admin-guide.html" cp -f "$ROOT/static/docs/admin-guide.html" "$STAGE/Documentation/admin-guide.html" cp "$ROOT/README.md" "$STAGE/Main Files/README.md" # --------------------------------------------------------------------------- # START-HERE.html — open this first after unzipping # --------------------------------------------------------------------------- cat > "$STAGE/START-HERE.html" << 'EOF' START HERE — cPanel Deploy

TSN Digital Academy — Deploy on cPanel

Follow these steps on shared hosting with cPanel Setup Python App.

ZIP contents

Step 1 — Create MySQL database (recommended)

  1. cPanel → MySQL® Databases
  2. Create a database (e.g. academy)
  3. Create a MySQL user with a strong password
  4. Add the user to the database with ALL PRIVILEGES
  5. Note the full names (often cpaneluser_dbname / cpaneluser_dbuser)

Step 2 — Create Python App

  1. cPanel → Setup Python App → Create Application
  2. Python version: 3.10+ (3.11 or 3.12 if available)
  3. Application root: e.g. academy (folder where files will live)
  4. Application URL: your domain or subdomain
  5. Application startup file: passenger_wsgi.py
  6. Application Entry point: application
  7. Click Create

Step 3 — Upload files

  1. Open File Manager → go into the Application root folder
  2. Upload all contents of Main Files/ (not the folder name itself)
  3. You should see manage.py, passenger_wsgi.py, apps/, config/, etc.
  4. Do not upload a local .env, venv/, or db.sqlite3

Step 4 — Install packages

  1. In Setup Python App, copy the command under Enter to the virtual environment
  2. Open Terminal (or SSH), paste that command, press Enter
  3. Run: 
    cd ~/academy
pip install -r requirements.txt
python manage.py collectstatic --noinput
    (Replace ~/academy with your real application root.)

Step 5 — Restart & install

  1. Back in Setup Python App → Restart
  2. Open https://YOUR-DOMAIN/install/
  3. Complete the wizard (choose MySQL and enter the DB details from Step 1)
  4. Log in with the admin account you created in the installer
After install
  1. Dashboard → Admin Guide (full how-to for every module)
  2. Academy Settings → branding, payments, Email/SMTP
  3. Create a course → import questions → enable Free skill check if needed
If the site shows an error after upload

More detail: CPANEL-DEPLOY.txt · Documentation · Admin Guide

EOF # --------------------------------------------------------------------------- # CPANEL-DEPLOY.txt # --------------------------------------------------------------------------- cat > "$STAGE/CPANEL-DEPLOY.txt" << 'EOF' ================================================================================ TSN Digital Academy — cPanel shared hosting deploy guide ================================================================================ WHAT TO UPLOAD -------------- Upload everything INSIDE the "Main Files/" folder into your Python App root (the folder that contains manage.py after upload). Do NOT upload: venv/, .env, db.sqlite3, or this ZIP's Documentation/ folder into the app root (Documentation is for you to read offline). BEFORE YOU START ---------------- 1) Create a MySQL database + user in cPanel → MySQL® Databases (All Privileges). Write down: DB name, user, password, host (usually localhost). 2) cPanel → Setup Python App → Create: - Python 3.10+ (prefer 3.11/3.12) - Application root = e.g. academy - Application URL = your domain/subdomain - Startup file = passenger_wsgi.py - Entry point = application INSTALL PACKAGES ---------------- Copy the "Enter to the virtual environment" command from Setup Python App, open Terminal/SSH, then: cd ~/academy # your application root pip install -r requirements.txt python manage.py collectstatic --noinput Restart the Python App in cPanel. WEB INSTALLER ------------- Open: https://YOUR-DOMAIN/install/ Choose MySQL, enter DB credentials, set academy name + admin login. The installer writes .env, runs migrations, and creates your admin. AFTER INSTALL ------------- 1) Log in → open Admin Guide from the dashboard sidebar 2) Academy Settings → Branding, Payments, Email/SMTP (send a test email) 3) Manage Courses → create/publish courses 4) Import verified questions (needed for exams + Free skill check) 5) Toggle "Enable Free skill check" per course under Growth & marketing PERMISSIONS ----------- These folders must be writable by the app: media/ logs/ storage/ staticfiles/ STATIC & MEDIA -------------- - Static CSS/JS: WhiteNoise serves them after collectstatic - Media uploads: Django serves /media/ by default (SERVE_MEDIA=True in .env) COMMON PROBLEMS --------------- - 500 error after deploy → restart app; check passenger_wsgi.py + pip install - CSS missing → run collectstatic --noinput and restart - /install/ loops or blocked → delete storage/installed only if you intend to reinstall (also reset DB if needed) - Skill check error "need 12 verified questions" → import & verify questions SUPPORT FILES IN THIS ZIP ------------------------- START-HERE.html — visual quick start (open in browser) Documentation/index.html — product documentation Documentation/admin-guide.html — full admin how-to (every module) Main Files/ — application source ================================================================================ EOF # Seller / packaging note cp "$ROOT/PACKAGING.md" "$STAGE/README-SELLER.txt" 2>/dev/null || true ( cd "$STAGE" zip -r "$OUT_DIR/${NAME}.zip" . -x "*.DS_Store" -x "*/__pycache__/*" -x "*.pyc" ) # Also keep a short alias name cp -f "$OUT_DIR/${NAME}.zip" "$OUT_DIR/Academy-LMS-cPanel.zip" echo "" echo "Created:" ls -lh "$OUT_DIR/${NAME}.zip" "$OUT_DIR/Academy-LMS-cPanel.zip" echo "" echo "Upload Academy-LMS-cPanel.zip (or ${NAME}.zip) to your PC, unzip," echo "then follow START-HERE.html"