bench get-app https://github.com/Spearlance/ppt4ed-lms

[![Listed on Frappe Gems](https://frappegems.com/api/method/frappe_gems.seo.badge?app=Spearlance%2Fppt4ed-lms)](https://frappegems.com/gems/apps/Spearlance/ppt4ed-lms)

# PPT4ed LMS This repository is a **modified copy of [Frappe Learning](https://github.com/frappe/lms)** (not a GitHub fork — the source tree was copied and is maintained independently). It is maintained by [Spearlance / PPT4ed](https://www.ppt4ed.org) and runs in production at **devlms.ppt4ed.org**. At a high level, this version of Frappe LMS adds: - **In-person and live webinar sessions** — continuing-education Events with venue, event type, and CEU/credit-hour tracking, alongside the self-paced courses already supported upstream. - **A company credit system** — companies can purchase credits and assign them to their team members, who can then redeem those credits to enroll in courses and events. Includes an immutable credit ledger, a "My Credits" page for employees, and a PPT Employee user type. - Additional operational changes: Resend email integration (SMTP relay), company-employee homepage UX, and related backend/frontend adjustments. See git history and merged PRs for the full list. ## License and source availability - **License:** [GNU Affero General Public License v3](./license.txt) (AGPL v3) — inherited from upstream Frappe Learning. All modifications in this repository are also AGPL v3. - **Upstream project:** https://github.com/frappe/lms - **Modifications maintained since:** 2026 (see git history for the full commit log). Because this LMS runs as a publicly-accessible network service, AGPL v3 §13 requires that users interacting with it be offered access to the source of the running modified version. The in-app sidebar includes a **Source Code** link pointing to this repository to satisfy that requirement. If you received access to a running instance of this software and want the source code, you can obtain it from the repository linked above. ---
## Frappe Learning Frappe Learning is an easy-to-use learning system that helps you bring structure to your content. ### Motivation In 2021, we were looking for a Learning Management System to launch [Mon.School](https://mon.school) for FOSS United. We checked out Moodle, but it didn’t feel right. The forms were unnecessarily lengthy and the UI was confusing. It shouldn't be this hard to create a course right? So I started making a learning system for Mon.School which soon became a product in itself. The aim is to have a simple platform that anyone can use to launch a course of their own and make knowledge sharing easier. ### Key Features - **Structured Learning**: Design a course with a 3-level hierarchy, where your courses have chapters and you can group your lessons within these chapters. This ensures that the context of the lesson is set by the chapter. - **Live Classes**: Group learners into batches based on courses and duration. You can then create Zoom live class for these batches right from the app. Learners get to see the list of live classes they have to take as a part of this batch. - **Quizzes and Assignments**: Create quizzes where questions can have single-choice, multiple-choice options, or can be open ended. Instructors can also add assignments which learners can submit as PDF's or Documents. - **Getting Certified**: Once a learner has completed the course or batch, you can grant them a certificate. The app provides an inbuilt certificate template. You can use this or else create a template of your own and use that instead.

View Screenshots


_{Create batches to group your learners}


_{Evaluate their knowledge by quizzes}


_{Autenticate their work with certification}

### Under the Hood - [**Frappe Framework**](https://github.com/frappe/frappe): A full-stack web application framework. - [**Frappe UI**](https://github.com/frappe/frappe-ui): A Vue-based UI library, to provide a modern user interface. ## Production Setup ### Managed Hosting You can try [Frappe Cloud](https://frappecloud.com), a simple, user-friendly and sophisticated [open-source](https://github.com/frappe/press) platform to host Frappe applications with peace of mind. It takes care of installation, setup, upgrades, monitoring, maintenance and support of your Frappe deployments. It is a fully featured developer platform with an ability to manage and control multiple Frappe deployments. ### Self Hosting Follow these steps to set up Frappe Learning in production: **Step 1**: Download the easy install script ```bash wget https://frappe.io/easy-install.py ``` **Step 2**: Run the deployment command ```bash python3 ./easy-install.py deploy \ --project=learning_prod_setup \ --email=your_email.example.com \ --image=ghcr.io/frappe/lms \ --version=stable \ --app=lms \ --sitename subdomain.domain.tld ``` Replace the following parameters with your values: - `your_email.example.com`: Your email address - `subdomain.domain.tld`: Your domain name where Learning will be hosted The script will set up a production-ready instance of Frappe Learning with all the necessary configurations in about 5 minutes. **Note:** To avoid a `404 Page Not Found` error: - If hosting on a **public server**, make sure your DNS **A record** points to your server's IP. - If hosting **locally**, map your domain to `127.0.0.1` in your `/etc/hosts` file: ## Development Setup ### Docker You need Docker, docker-compose and git setup on your machine. Refer [Docker documentation](https://docs.docker.com/). After that, follow below steps: **Step 1**: Setup folder and download the required files mkdir frappe-learning cd frappe-learning # Download the docker-compose file wget -O docker-compose.yml https://raw.githubusercontent.com/frappe/lms/develop/docker/docker-compose.yml # Download the setup script wget -O init.sh https://raw.githubusercontent.com/frappe/lms/develop/docker/init.sh **Step 2**: Run the container and daemonize it docker compose up -d **Step 3**: The site [http://lms.localhost:8000/lms](http://lms.localhost:8000/lms) should now be available. The default credentials are: - Username: Administrator - Password: admin ### Local To setup the repository locally follow the steps mentioned below: 1. Install bench and setup a `frappe-bench` directory by following the [Installation Steps](https://frappeframework.com/docs/user/en/installation) 1. Start the server by running `bench start` 1. In a separate terminal window, create a new site by running `bench new-site learning.test` 1. Map your site to localhost with the command `bench --site learning.test add-to-hosts` 1. Get the Learning app. Run `bench get-app https://github.com/frappe/lms` 1. Run `bench --site learning.test install-app lms`. 1. Now open the URL `http://learning.test:8000/lms` in your browser, you should see the app running ## Learn and connect - [Telegram Public Group](https://t.me/frappelms) - [Discuss Forum](https://discuss.frappe.io/c/lms/70) - [Documentation](https://docs.frappe.io/learning) - [YouTube](https://www.youtube.com/channel/UCn3bV5kx77HsVwtnlCeEi_A)