> For the complete documentation index, see [llms.txt](https://docs.verge.io/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.verge.io/run-the-platform/tenants.md).

# Tenants

- [Increasing a Tenant's Resources](https://docs.verge.io/run-the-platform/tenants/add-tenant-resources.md): Instructions for adding compute and storage resources to a tenant, including scaling existing tenant nodes, adding new nodes, and provisioning additional storage tiers.
- [Assigning External IP Addresses to a Tenant](https://docs.verge.io/run-the-platform/tenants/assign-ip-to-tenant.md): Instructions for assigning external IP addresses to a tenant, including creating virtual IPs and applying network rules for tenant external access.
- [Creating Tenants](https://docs.verge.io/run-the-platform/tenants/create-tenants.md): Step-by-step instructions for creating new tenants in VergeOS using the Tenant Wizard, cloning an existing tenant, or deploying from a tenant recipe.
- [Configure Tenant Layer 2 Networks](https://docs.verge.io/run-the-platform/tenants/layer-2-networks.md): How to configure Tenant Layer 2 Networks in VergeOS to pass VLANs directly to tenant environments, including creation, verification, VM attachment, and removal procedures.
- [Tenants (Virtual Data Centers)](https://docs.verge.io/run-the-platform/tenants/overview.md): Overview of VergeOS multi-tenancy, providing secure, encapsulated virtual data centers with full network isolation, nested tenancy, resource tracking, and portable self-contained environments.
- [Providing Files to a Tenant](https://docs.verge.io/run-the-platform/tenants/provide-files-to-tenant.md): How to share files from the parent vSAN with a tenant, including ISO images, VM disk images, and other uploaded files.
- [Reducing a Tenant's Resources](https://docs.verge.io/run-the-platform/tenants/reduce-tenant-resources.md): Instructions for reducing tenant compute resources by deleting tenant nodes or decreasing cores and RAM allocated to existing nodes.
- [Share a VM Snapshot between Provider and Tenant](https://docs.verge.io/run-the-platform/tenants/share-vm-snapshot.md): How to use the Shared Objects feature to share VM snapshots between a service provider and tenant, enabling snapshot-based VM transfers in both directions.
- [Modifying Tenants](https://docs.verge.io/run-the-platform/tenants/tenant-modifications.md): Reference for editing tenant properties including name, URL, admin password, theme access, OIDC authentication, UI address, and snapshot exposure settings.
- [Monitoring Tenants](https://docs.verge.io/run-the-platform/tenants/tenant-monitoring.md): Guide to monitoring tenants using dashboards, usage statistics, logs, and email subscriptions for alerts and scheduled reports.
- [Tenant Restores](https://docs.verge.io/run-the-platform/tenants/tenant-restores.md): Instructions for restoring an existing or deleted tenant from system snapshots, including provider-initiated and tenant self-service restore workflows.
- [Tenant Snapshots](https://docs.verge.io/run-the-platform/tenants/tenant-snapshots.md): How to manage tenant snapshots including exposing provider snapshots to tenants, restoring tenants from snapshots, and tenant self-service snapshot access and VM recovery.
- [Tenant Usage Reports](https://docs.verge.io/run-the-platform/tenants/tenant-usagereports.md): How to run tenant usage history reports for 95th percentile billing, view average and maximum statistics, export CSV data, and configure subscription-based usage report emails.


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter, and the optional `goal` query parameter:

```
GET https://docs.verge.io/run-the-platform/tenants.md?ask=<question>&goal=<endgoal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is optional and describes the broader end goal you are ultimately trying to accomplish on behalf of the user. GitBook uses it to tailor the answer towards what is most useful for that goal.

The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.
