Multi-Tenant Design
EmberNet is multi-tenant at every layer. Data, configuration, network identity, and access are separated between tenants by the platform itself rather than by convention. A tenant is one organization: a customer, a partner, or a business unit.
How isolation works
Data
Every device, site, alert, app, and audit record belongs to a tenant, and the server checks that ownership on every request. A request for another tenant's data gets a clear refusal instead of a quietly filtered empty result.
Network
Tenant workloads carry their own network identities on Flux, and each tenant has its own private network. Collectors that reach devices directly are held to the tenant's own recorded sites. Cross-tenant traffic is denied by default. See Zero-Trust Networking.
Messaging
On AnvilMQ, each tenant's credentials reach only that tenant's data.
Access
People hold a role in each tenant separately, and a role in one tenant never raises what they can do in another. The tenant roles are Admin, Manager, Engineer, Plant Supervisor, Maintenance, Operator, Auditor, and Viewer, and each lands in an EmberCORE view built for it. How roles are granted is covered in SSO Integration.
| Role | Scope | What they do |
|---|---|---|
| Global Command | Every tenant | Fireball's platform role: tenants, global configuration, cross-fleet oversight |
| Admin | Own tenant | Users, sites, devices, apps, storage, network, and shells on what the tenant owns |
| Manager | Own tenant | Operations oversight: metrics and reports. Managers and Admins receive alert emails |
| Engineer | Own tenant | Deploying apps, logs, events, metrics, network devices, and a read-only broker view |
| Plant Supervisor | Own tenant | Everything an Operator does, plus the plant's operator roster and its metrics, read only |
| Maintenance | Own tenant | What an Operator does, plus logs and events |
| Operator | Own tenant | Live status, opening apps, acknowledging alerts, operator notes, and end of shift |
| Auditor | Own tenant | Read only, plus logs, events, metrics, and the audit trail |
| Viewer | Own tenant | A read-only view of nodes and sites |
Each role starts from a default set of permissions. Fireball can change the defaults platform-wide, and a tenant's Admins can change them for their tenant.
Global Command is the only place aggregate, cross-tenant data is ever shown. Every other role is confined to its own tenant, and that confinement is enforced on the server rather than by hiding controls in the interface.
Tenant lifecycle
Onboarding
- Fireball creates the tenant and connects its sites and nodes.
- Fireball invites the first Admin.
- Admins invite their people and give each one a role, or Fireball maps their directory groups to roles.
- Devices are registered to the tenant, and collectors and SNMP are set up against them.
Enterprises bringing their own cluster follow a different path; see External Tenants.
What each tenant controls
- Its users and the role each one holds
- Its sites, buildings, and devices
- The apps it deploys, and which apps its catalog offers
- Its device collectors and SNMP credentials
- Whether its audit trail is also exported to its own storage
Retention of the audit log is a platform-level setting, kept for seven years by default. See Configuration Reference.
Leaving
To remove a tenant, contact Fireball.
Operating many tenants
Platform staff work from Global Command, where the Client Switcher is the single control for scope. Leave it on All Clients for the aggregate picture, or select a client to drill the entire console into that one tenant.
Day-to-day fleet work happens in Ops & Clusters, which covers cluster health and deployment status across everything you can see.
Scale
New tenants are added without affecting existing ones, and edge clusters scale independently based on what each tenant's workload actually needs. A single control plane supports hundreds of tenants.
Next steps
- SSO Integration: binding users to tenants and roles
- External Tenants: customers running their own clusters
- EmberCORE Overview: the views each role lands in