Moodle Plugins directory: Multi-tenancy | Moodle.org

Multi-tenancy
What is Multi-tenancy?
Multitenancy makes it possible to handle a variety of use cases, such as:
-
Corporate Training
Create separate tenants for departments, regions, or subsidiaries. This setup allows for tailored training programs, while management stays centralized.
Example: A multinational corporation can set up tenants for Europe, Asia, and the Americas, each with its own specific training content while sharing global compliance courses. -
Client Training
Offer customized learning environments for each client with unique permissions and branding.
Example: A consultancy firm provides training portals for different clients, ensuring each client sees their unique branding and only their specific training materials. -
Partner and Vendor Training
Provide dedicated tenants for external partners or vendors, giving them secure access to their training materials without interfering with internal operations.
Example: A manufacturing company trains its distributors and suppliers through separate partner-specific tenants, ensuring they only access relevant information. -
Franchise Management
Give franchisees their own tenants to run localized training programs while keeping things consistent across the organization.
Example: A restaurant franchise offers tenants for franchise owners to manage staff training tailored to their region while enforcing corporate standards. -
Shared Resources
Use shared spaces between tenants to distribute common resources, like compliance courses or company announcements.
Example: A global healthcare company shares mandatory compliance training across tenants while allowing each region to manage its additional training needs.
Drawbacks of Multi-tenancy
-
Later Splitting of Tenants is Hard
Breaking up one multi-tenant site into separate independent sites can be a very complex process, requiring site cloning and a lot of data cleanup. -
Shared Infrastructure Issues
If one tenant uses too many resources, it can slow things down for everyone else. -
Limited Customization
Tenants can make some branding and setting changes, but they're more limited compared to standalone Moodle™ instances. -
Security Concerns
Even with isolation measures, shared infrastructure creates the risk of vulnerabilities affecting multiple tenants. -
Plugin and Feature Restrictions
Some standard functionalities might not work as expected, and third-party plugins like enrolment or authentication tools may need significant adjustments.
Installation steps
- Apply the multi-tenancy patch to Moodle™ codebase: GitHub Repository
- Install the
tool_mulib
plugin: GitHub Plugin Page - Install the
tool_mutenancy
plugin: GitHub Plugin Page - Install or upgrade the site
- Login as site administrator
- Activate multi-tenancy in: Site administration / General / Tenants
- Start creating tenants and member accounts
Known Limitations
- Only the latest Moodle™ 4.5.x releases to be supported in 2025.
- Supported databases: PostgreSQL and MariaDB (MySQL is not recommeded).
- 64-bit PHP is required.
- Tenant-specific appearance settings may not display correctly in the Moodle Mobile App.
Support
- Report bugs: GitHub Issues
- Report security vulnerabilities: security@mutms.org
Paid support options will be available starting in 2026.
Comments