# Tenants

> Understand principles and concepts of Capsule Tenants

> For the complete documentation index, see [llms.txt](https://projectcapsule.dev/llms.txt).
> The HTML version of this page is at https://projectcapsule.dev/docs/tenants/.

Capsule is a framework to implement multi-tenant and policy-driven scenarios in Kubernetes. In this tutorial, we'll focus on a hypothetical case covering the main features of the Capsule Operator. This documentation is styled in a tutorial format, and it's designed to be read in sequence. We'll start with the basics and then move to more advanced topics.

**Acme Corp**, our sample organization, is building a Container as a Service platform (CaaS) to serve multiple lines of business, or departments, e.g. Solar, Wind, Water. Each department has its team of engineers that are responsible for the development, deployment, and operating of their digital products. We'll work with the following actors:

* **Bill**: the cluster administrator from the operations department of Acme Corp.
* **Alice**: the project leader in the Solar & Green departments. She is responsible for a team made of different job responsibilities: e.g. developers, administrators, SRE engineers, etc.
* **Joe**: works as a lead developer of a distributed team in Alice's organization.
* **Bob**: is the head of engineering for the Water department, the main and historical line of business at Acme Corp.

This scenario will guide you through the following topics.

## Pages in this section

- [Namespaces](https://projectcapsule.dev/docs/tenants/namespaces/index.md): Namespace to Tenant relation
- [Permissions](https://projectcapsule.dev/docs/tenants/permissions/index.md): Grant permissions for tenants
- [Administration](https://projectcapsule.dev/docs/tenants/administration/index.md): Administrative controls on tenants
- [Metadata](https://projectcapsule.dev/docs/tenants/metadata/index.md): Inherit additional metadata on Tenant resources.
- [Rules](https://projectcapsule.dev/docs/tenants/rules/index.md): Configure policies and restrictions on a per-Namespace basis with Rules
- [Enforcement](https://projectcapsule.dev/docs/tenants/enforcement/index.md): Configure policies and restrictions on tenant-basis
- [Quotas](https://projectcapsule.dev/docs/tenants/quotas/index.md): Strategies on granting quotas on tenant-basis

---

Last modified August 21, 2026: feat: rewrite quickstart and refactor page ordering (#117) (#125) (040fb2a)