RAGING
Comms
DashboardCalendarServicesBillingSupportMy ShipmentsHelp & GuidesAdd-onsRefer a FriendPasskeysSettings
© 2026 Raging Communications

Multi-Tenant Onboarding Guide

Complete guide for setting up a new tenant on the platform

1
Create Tenant Record
Set up the basic tenant configuration

Navigate to: Admin → Multi-Tenancy → All Tenants

  1. Click
    Add Tenant
    button
  2. Fill in required fields:
    • Setting Key: Unique identifier (e.g., acme, tenant1) - CANNOT be changed later
    • Company Name: Legal company name (e.g., "Acme Communications Pty Ltd")
    • Tagline: Company slogan (e.g., "Connecting Australia")
    • Logo URL: Link to company logo (hosted externally)
    • General Email: Primary contact email
    • Phone Numbers: Regional contact numbers
  3. Click
    Save Tenant
2
Complete Company Settings
Configure detailed tenant information

Navigate to: Admin → Settings → Company

Complete all relevant tabs:

General Tab

  • • ABN/ACN numbers
  • • Website URL
  • • Timezone & Language

Contact Tab

  • • All department emails
  • • Regional phone numbers
  • • Support hours

Address Tab

  • • Physical business address
  • • Visibility toggles

Payments Tab

  • • Stripe surcharge rates
  • • Payment processing fees
3
Assign Subscription Plan
Set up billing and feature access

Navigate to: Admin → Subscriptions → Company Subscriptions

  1. Click
    New Subscription
  2. Select the tenant from dropdown
  3. Choose subscription plan (Starter, Professional, Enterprise)
  4. Select billing frequency (Monthly or Annual)
  5. Enter billing email address
  6. Click
    Create Subscription
4
Configure Custom Domain (Optional)
Point tenant's domain to the platform

Custom Domain Setup

A. Update Tenant Record

  1. Go to Admin → Multi-Tenancy → All Tenants
  2. Click Edit on the tenant
  3. Add custom domain in the dialog (e.g., app.acme.com)
  4. Save changes

B. Tenant DNS Configuration (Share with Customer)

The tenant must add a CNAME record in their DNS provider:

Type:
CNAME
Name:
app (or subdomain)
Value:
your-app.base44.com

⚠️ DNS propagation can take 1-48 hours. SSL certificates are automatically provisioned by Base44.

C. Verify Domain

  1. Wait for DNS propagation (usually 1-2 hours)
  2. Visit the custom domain (e.g., https://app.acme.com)
  3. Verify tenant branding and data isolation
5
Invite Tenant Administrators
Set up admin access for the tenant

Navigate to: Admin → Settings → Permissions

  1. Click
    Invite User
  2. Enter tenant admin email address
  3. Select role: Admin
  4. Select staff level: Executive or Manager
  5. Choose department
  6. Click
    Send Invitation
✓
Verify Tenant Setup
Checklist before going live
  • Tenant appears in Admin → Multi-Tenancy → All Tenants
  • Subscription is active with correct plan
  • Custom domain resolves correctly (if configured)
  • Tenant branding (logo, colors) displays correctly
  • Admin user can log in and access tenant dashboard
  • Data isolation verified (tenant can only see their data)
Quick Reference: Multi-Tenant Architecture
Data Isolation: All customer, service, invoice, and ticket data includes a company_id field that links to the tenant's setting_key. Row-Level Security (RLS) rules automatically enforce isolation.
Branding: Each tenant can customize their logo, colors, contact information, and messaging through Company Settings.
Billing: Each tenant has their own Stripe subscription with independent billing cycles, payment methods, and invoicing.
Domain Mapping: The platform detects the current domain (window.location.hostname) and matches it to a tenant's custom_domain field to load the correct branding and data scope.