Connect students and instructors through structured courses, live sessions, auto-graded quizzes, and verified certificates — fully self-hosted, no external dependencies, entirely yours.
CrunkTechSoft LMS is a full-featured Learning Management System that connects students with instructors through structured course content, live sessions, quizzes, and certified learning paths. Completely self-hosted — all videos, documents, and thumbnails stored on your own server with zero external CDN or streaming platform dependency.
Three distinct roles — each with a dedicated navigation experience, permission set, and dashboard.
Complete platform lifecycle — from user registration through course completion and certificate issuance.
Total users, courses, enrolments, certificates. Recent signups and role breakdown with percentage bars.
Create any role account. Edit name, role, bio, password. Suspend, activate, or delete permanently.
View all courses across all instructors. See enrolment counts and published vs draft ratio platform-wide.
Publish or unpublish any course. Delete any course from the platform. Full instructor access for admin-owned content.
Detailed breakdown of every module, screen, and capability available in the platform.
Create, edit, delete courses. Thumbnail upload. Publish/draft toggle. Category + level + duration metadata. Slug auto-generated from title.
Organise content into Sections. Each section holds unlimited Lessons. 4 lesson types: Video, Document, Live, Quiz. Order-indexed for sequence control.
Upload MP4/WebM up to 500 MB. Stored in /uploads/videos/. HTML5 video player with full controls. Served via Express static — no external streaming needed.
Upload PDF/DOCX up to 50 MB. Students get a direct download/open link. Supports text notes alongside documents.
Countdown timer. Multiple choice A/B/C/D. Auto-graded on submit. Pass/fail by instructor-set threshold. Best attempt tracked. Full answer review shown after.
Schedule with date, time, duration, and Zoom/Meet URL. Status lifecycle: Scheduled → Live → Ended. Students see upcoming sessions on their dashboard.
Per-lesson completion stored in DB. Per-course progress % calculated from completed/total lessons. Progress bar on course cards and detail page.
On 100% lesson completion, system auto-issues a certificate with unique number (CERT-userId-courseId-timestamp). Displayed as visual certificate cards — downloadable.
Full-text search on course title and instructor name (PostgreSQL ILIKE). Filter by level. Paginated results (12 per page). Open to non-enrolled users.
Instructors can mark individual lessons as "Free Preview" — accessible by anyone without enrolling. Students sample content before committing, significantly increasing enrolment conversion.
All files stored on the server under
/backend/uploads/videos/,
/documents/, and
/thumbnails/. Served as Express static assets. Naming convention:
{type}_{userId}_{timestamp}.{ext}
to prevent collisions.
JWT-based stateless authentication with role-based access control across all API endpoints.
All passwords hashed with bcryptjs (10 salt rounds). Plain passwords never saved in the database. Admin can reset any user's password at any time.
JWT tokens expire after 24 hours. Axios response interceptor catches 401, clears localStorage, and redirects to login. Configurable via JWT_EXPIRES_IN env variable.
Every sensitive endpoint uses protect() + authorize() middleware. Frontend Route Guards also prevent navigation to restricted pages without the correct role in the JWT payload.
Complete REST API surface. All endpoints return JSON.
Authenticated routes require
Authorization: Bearer <jwt>
header.
| Method + Route | Auth | Description |
|---|---|---|
| POST /api/auth/register | Public | Register new user — returns JWT + user object |
| POST /api/auth/login | Public | Authenticate with email/password — returns JWT + user object |
| GET /api/auth/me | JWT | Get current authenticated user with enrolled course count |
| PUT /api/auth/me | JWT | Update own profile name and bio |
| Method + Route | Auth | Description |
|---|---|---|
| GET /api/courses | Public | List published courses — supports ?search, ?level, ?page, ?limit |
| GET /api/courses/my | JWT | Get student's enrolled courses with progress % each |
| GET /api/courses/:id | Public | Get single course with full sections and lessons curriculum |
| GET /api/courses/:id/progress | JWT | Get lesson completion status for a course (student) |
| POST /api/courses | Instructor | Create a new course (starts as draft) |
| PUT /api/courses/:id | Instructor | Update course fields including publish/unpublish toggle |
| DELETE /api/courses/:id | Instructor | Delete own course — cascades all sections, lessons, enrolments |
| POST /api/courses/:id/enroll | Student | Enrol authenticated student in course (idempotent) |
| GET /api/courses/instructor/mine | Instructor | Get all courses created by the authenticated instructor |
| Method + Route | Auth | Description |
|---|---|---|
| GET /api/lessons/sections | JWT | Get all sections with nested lessons for a course (?course_id=) |
| POST /api/lessons/sections | Instructor | Add new section to a course |
| GET /api/lessons/:id | JWT | Get lesson with content URL, prev/next nav, completion status |
| POST /api/lessons | Instructor | Add lesson to section — type: video | document | live | quiz |
| POST /api/lessons/:id/complete | JWT | Mark lesson complete; auto-issues certificate if course finished |
| Method + Route | Auth | Description |
|---|---|---|
| GET /api/quizzes/:id | JWT | Get quiz with questions (correct answers hidden) + best attempt |
| POST /api/quizzes | Instructor | Create quiz with questions array attached to a lesson |
| POST /api/quizzes/:id/submit | JWT | Submit answers — returns score, passed bool, answer review |
| GET /api/live | JWT | List live sessions — ?upcoming=1 for future only |
| POST /api/live | Instructor | Schedule new live session |
| PUT /api/live/:id | Instructor | Update session status: scheduled → live → ended |
| POST /api/upload/:type | Instructor | Upload file — type: video | document | thumbnail (multipart/form-data) |
| GET /api/dashboard/student | JWT | Student stats: enrolled, completed, lessons done, avg score, certs |
| GET /api/dashboard/instructor | Instructor | Instructor stats: course count, total students |
| GET /api/dashboard/certificates | JWT | Get all certificates earned by authenticated user |
| GET /api/dashboard/admin | Admin | Platform stats + recent users list |
| GET /api/admin/users | Admin | Get all users (all roles) |
| POST /api/admin/users | Admin | Create new user with any role |
| PUT /api/admin/users/:id | Admin | Edit user: name, role, bio, is_active, password reset |
| DELETE /api/admin/users/:id | Admin | Permanently delete user account |
| GET /api/admin/courses | Admin | Get all courses with enrolment counts |
| PUT /api/admin/courses/:id | Admin | Update any course (publish/unpublish) |
| DELETE /api/admin/courses/:id | Admin | Delete any course from platform |
| GET /api/categories | Public | Get all categories (for dropdowns) |
12-table PostgreSQL schema with foreign key constraints, cascading deletes, and JSONB for quiz answer storage.
Deleting a Course cascades to: Sections → Lessons → Enrolments → Lesson Progress → Quiz Attempts → Certificates. Deleting a User cascades to all their enrolments, progress, quiz attempts, certificates, and courses. All foreign keys use ON DELETE CASCADE.
Modern, production-ready stack with zero external service dependencies for core functionality — deploy on any VPS with Node.js and PostgreSQL.
Server-local under /uploads/. Videos 500 MB, Documents 50 MB, Thumbnails 5 MB. Served as Express static. Filename collision-safe.
No AWS S3, no Stripe, no Firebase, no Cloudinary. Fully self-contained. Runs on any VPS with Node.js and PostgreSQL.
Frontend builds to static files. Backend runs as a Node process. Compatible with Render, Railway, DigitalOcean, or any Linux server.
At a glance
| Platform | Self-hosted LMS |
| Roles | Student, Instructor, Admin |
| Content Types | Video, Document, Live, Quiz |
| Database | PostgreSQL |
| Auth | JWT HS256 — 24h expiry |
| File Storage | Server-local (no CDN) |
| Certificates | Auto-issued, unique ID + QR |
| Frontend | React 18 + Vite 5 |
| Backend | Node.js + Express 4 |
| Support | Phone, Email & WhatsApp |
| Languages | Tamil & English |
Book a free 30-minute demo. We will walk you through setting up your first course, enrolling learners, and issuing certificates — in Tamil or English.
Book Free Demo