Management UI & URL
Each tenant has its own web-based management interface accessible via a unique URL. Tenant admins can manage all resources, VMs, networks, and settings through this dedicated interface — no shared management plane.
A tenant in VergeOS is a complete Virtual Data Center (VDC) — a fully self-contained environment that includes all the functionality of a base VergeOS system, excluding physical hardware management. Each tenant is essentially a “data center within a data center,” providing an isolated environment for different users, organizations, or workloads.
Every tenant operates independently with its own:
Unlike traditional multi-tenancy approaches that rely on logical separation (VLANs, resource pools, or RBAC boundaries), VergeOS tenants provide true architectural isolation — each tenant is a fully encapsulated environment with its own networking, storage volumes, and administrative boundary.
The fundamental difference between VergeOS tenancy and competing approaches is the level of isolation provided. Most platforms offer logical isolation — RBAC policies, network policies, and resource quotas that separate tenants within a shared management plane. VergeOS delivers architectural isolation through two key mechanisms:
Every tenant receives complete Layer 2/Layer 3 network encapsulation. When a new tenant is created, VergeOS automatically provisions:
Tenant network traffic is fully encapsulated and isolated from other tenants and from the host system. This is fundamentally different from VLAN-based segmentation, where misconfiguration can expose traffic between tenants.
Each tenant receives dedicated storage volumes allocated from the parent vSAN. Storage isolation ensures that:
Together, network encapsulation and exclusive storage volumes provide true isolation — not just policy-based separation, but architectural boundaries that prevent cross-tenant access by design.
VergeOS supports a hierarchical tenant model with two key levels:
The host system (also called the provider or parent) is the physical VergeOS installation that owns the hardware. The host system administrator has full control over:
Each tenant operates as an independent VDC. Tenant administrators can manage everything within their allocated resources:
One of VergeOS’s most powerful capabilities is nested multi-tenancy. Each tenant can create sub-tenants from its own allocated resources, creating a hierarchical structure that supports complex organizational and service requirements.
For example, a service provider (Tenant A) can create customer tenants (Sub-Tenants A1, A2), and those customers can further subdivide their environments into dev/prod sub-tenants. Each level maintains full isolation and independent management.
Every tenant in VergeOS receives a comprehensive set of capabilities, making each VDC a fully functional environment:
Management UI & URL
Each tenant has its own web-based management interface accessible via a unique URL. Tenant admins can manage all resources, VMs, networks, and settings through this dedicated interface — no shared management plane.
User Management
Tenants support flexible identity management: local user accounts, authentication through the parent system, third-party identity providers (OAuth2/OIDC such as Okta, Azure AD/Entra, Google), or a combination. MSPs can centralize login across all tenant environments.
Resource Tracking & Billing
Per-tenant resource tracking includes CPU, RAM, storage consumption, and deduplication statistics. Usage reports facilitate billing, auditing, and capacity planning — critical for service providers who bill per-tenant.
Backup & Disaster Recovery
DR protocols can be customized per tenant. Each tenant can control their own snapshot and retention schedules, while the host system’s snapshots also capture all tenants for system-wide recovery.
Portability
Each tenant is a portable, self-contained system. An entire VDC — including all VMs, networks, storage, and configuration — can be snapshotted, replicated via site sync, or moved to a different VergeOS installation as a single unit.
Custom Branding & Themes
Parent systems can permit tenants to brand their UI with custom company logos, color schemes, and font selections using VergeOS Themes. This is especially valuable for MSPs who want to provide white-label services.
| Feature | Description |
|---|---|
| Management UI | Dedicated web interface per tenant with unique URL |
| User Management | Local, parent-delegated, or third-party IdP (OIDC/OAuth2) |
| Resource Tracking | Per-tenant CPU, RAM, storage, and dedup statistics |
| Backup/DR | Individualized snapshot schedules and retention policies |
| Portability | Entire VDC can be snapshotted, replicated, or relocated |
| Custom Branding | Themes with logos, colors, and fonts (parent-controlled) |
| Automated Deployment | Tenant Recipes for rapid, standardized provisioning |
| Networking | Full SDN stack with firewall, NAT, DHCP, DNS per tenant |
VergeOS multi-tenancy serves a wide range of deployment scenarios:
Cloud Service Providers (CSPs) and Managed Service Providers (MSPs) use VergeOS tenancy to deliver multi-tenant IaaS with:
Enterprises use tenants to segment infrastructure while maintaining centralized management:
Educational institutions benefit from tenant isolation for:
VergeOS tenants are inherently portable, enabling powerful DR scenarios:
It is important to understand that a VergeOS tenant is not simply a virtual machine. While VMs provide compute isolation, a tenant provides a complete infrastructure isolation boundary:
| Aspect | Virtual Machine | VergeOS Tenant (VDC) |
|---|---|---|
| Scope | Single workload | Complete data center |
| Networking | NIC(s) on shared network | Full SDN stack (DMZ, internal, external) |
| Storage | Virtual disk(s) | Dedicated storage volumes from vSAN |
| Management | Managed by host admin | Independent admin UI + users |
| Nesting | N/A | Can create sub-tenants |
| Portability | Single VM migration | Entire environment as one unit |
| Identity | Host-level auth only | Independent IdP / OIDC |
VergeOS multi-tenancy is a first-class platform feature — not a bolt-on product or configuration overlay. Each tenant is a complete Virtual Data Center with architectural isolation (network encapsulation + exclusive storage volumes), a dedicated management interface, independent user management, and full portability. The hierarchical tenant model supports unlimited nesting, enabling service providers, enterprises, and educational institutions to build sophisticated multi-tenant environments with true isolation at every level.
In the next section, we will walk through the practical steps of creating and configuring tenants using the VergeOS UI.