Skip to main content

Multi-Tenancy Core

Multi-database multitenancy module with SaaS management for Laravel ERP. This module is required for the SaaS edition and enables running Open Core Business Suite as a multi-tenant platform.

Features​

  • Multi-Database Tenancy: Complete database isolation per tenant for security and performance
  • Tenant Management: Full CRUD operations for managing tenants from the central admin
  • Tenant Provisioning: Automated tenant setup including database creation and seeding
  • Subdomain Routing: Automatic subdomain-based tenant identification and routing
  • Tenant Isolation: Complete data isolation ensuring tenants cannot access each other's data
  • Central Admin Panel: Manage all tenants from a centralized administration interface
  • Subscription Management: Track tenant subscriptions and plan limits
  • Tenant Impersonation: Admin ability to access tenant accounts for support

Requirements​

  • Open Core Business Suite (Base System)
  • Database server with permissions to create databases
  • Wildcard subdomain configuration on your server

Installation​

  1. Download the Multi-Tenancy Core module package
  2. Extract the module to Modules/MultiTenancyCore
  3. Run the installation command:
php artisan module:enable MultiTenancyCore
php artisan migrate
  1. Configure your web server for wildcard subdomains
  2. Clear the application cache:
php artisan optimize:clear

Usage​

Tenant Management​

Navigate to Central Admin > Tenants to manage tenants:

  • Create new tenants with company details
  • Assign subscription plans and limits
  • View tenant status and usage statistics
  • Suspend or delete tenants

Tenant Provisioning​

When creating a new tenant:

  1. Enter company details and admin user information
  2. Select a subscription plan
  3. The system automatically:
    • Creates a dedicated database
    • Runs all migrations
    • Seeds initial data
    • Creates the admin user
    • Configures subdomain routing

Subdomain Routing​

Tenants access their instance via subdomains:

  • tenant1.yourdomain.com - Routes to Tenant 1
  • tenant2.yourdomain.com - Routes to Tenant 2
  • admin.yourdomain.com - Central admin panel

Tenant Isolation​

Each tenant has:

  • Separate database with all tables
  • Isolated file storage
  • Independent configuration
  • Separate cache keys

Configuration​

Access module settings at Settings > Multi-Tenancy to configure:

  • Default tenant plan and limits
  • Tenant creation settings
  • Database naming conventions
  • Subdomain configuration
  • Storage path patterns

SaaS Edition Note​

This module is included only in the SaaS edition of Open Core Business Suite. It is not available in the standard single-tenant package.

Last updated on