Skip to main content

Multi-Tenant

Isolation​

Each tenant has:

  • A separate MySQL database
  • Independent users, devices, and scenes
  • Private branding settings

Access​

MethodExample
Subdomainacme.homatic.io
HeaderX-Tenant-Subdomain: acme

Central API (Super Admin)​

POST /api/central/v1/auth/login
GET  /api/central/v1/tenants
POST /api/central/v1/tenants/{id}/activate

Central host: https://api.homatic.io

Tenant API​

POST https://acme.homatic.io/api/v1/auth/login
Authorization: Bearer {token}

Provisioning​

php artisan tenants:migrate
php artisan tenants:seed

Security​

  • Never share tokens across tenants
  • Always use HTTPS in production