> For the complete documentation index, see [llms.txt](https://docs.duplocloud.com/docs/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.duplocloud.com/docs/automation-platform/overview-2/quick-start/step-2-tenant.md).

# Step 2: Create a Tenant

Now that the [Infrastructure and Plan ](/docs/automation-platform/overview-2/quick-start/step-1-infrastructure.md)exist and [AKS has been enabled](/docs/automation-platform/overview-2/quick-start/step-1-infrastructure.md#enabling-the-aks-kubernetes-cluster), create one or more Tenants that use the configuration DuploCloud created.

[Tenants ](/docs/automation-platform/application-focused-interface-duplocloud-architecture/tenant.md)in DuploCloud are similar to projects or workspaces and have a subordinate relationship to the Infrastructure. Think of the Infrastructure as a virtual "house" (cloud), with Tenants conceptually "residing" in the Infrastructure performing specific workloads that you define. As Infrastructure is an abstraction of a Virtual Private Cloud. Tenants abstract the segregation created by a [Kubernetes Namespace](https://kubernetes.io/docs/concepts/overview/working-with-objects/namespaces/), although Kubernetes Namespaces are only one component that Tenants can contain.

In Azure, Microsoft cloud features such as Azure resource groups, Azure managed identity, Azure application security groups (ASG), and KMS keys are exposed in Tenants, which reference these feature configurations.

*Estimated time to complete Step 2: 10 minutes.*

## Tenant Use Cases

DuploCloud customers often create at least two Tenants for their production and non-production cloud environments (Infrastructures).

For example:

* **Production Infrastructure**
  * Pre-production Tenant - for preparing or reviewing production code
  * Production Tenant - for deploying tested code
* **Non-production Infrastructure**
  * Development Tenant - for writing and reviewing code
  * Quality Assurance Tenant - for automated testing

In larger organizations, some customers create Tenants based on application environments (i.e., one Tenant for Data Science applications and another Tenant for web applications), and so on.

Other customers create Tenants to isolate a single customer workload, allowing more granular performance monitoring, scaling flexibility, or tighter security. This is referred to as a *single-Tenant* setup.

## Prerequisites

Before creating a Tenant, verify that you accomplished the tasks in [Step 1](/docs/automation-platform/overview-2/quick-start/step-1-infrastructure.md) of this tutorial. Using the DuploCloud Portal, confirm that:

* An [Infrastructure and Plan exist](/docs/automation-platform/overview-2/quick-start/step-1-infrastructure.md), both with the name **NONPROD**.
* The **NONPROD** infrastructure has [Azure Kubernetes Service (AKS) **Enabled**](/docs/automation-platform/overview-2/quick-start/step-1-infrastructure.md#enabling-the-aks-kubernetes-cluster).

## Creating a Tenant

Create a Tenant for your Infrastructure and Plan:

1. In the DuploCloud Portal, navigate to **Administrator** -> **Tenants.**
2. Click **Add**. The **Create a Tenant** pane displays.
3. Enter **dev01** in the **Name** field.
4. Select the **Plan** that you created in the previous step (**NONPROD**).
5. Click **Create**.

<div align="left"><figure><img src="/files/38KUs5kZAnbWgmWTEC9h" alt=""><figcaption><p><strong>Create a Tenant</strong> pane</p></figcaption></figure></div>

## Checking Your Work

1. Navigate to **Administrator** -> **Tenants** and verify that the **dev01** Tenant displays in the list.<br>

   <figure><img src="/files/I7KFmZ5KhMMAuy7LyPU0" alt=""><figcaption><p><strong>Tenant</strong> page with Tenant <strong>dev01</strong> using Plan <strong>NONPROD</strong></p></figcaption></figure>
2. Navigate to **Administrator** -> **Infrastructure** and select **dev01** from the **Tenant** list box at the top left in the DuploCloud Portal. The **NONPROD** Infrastructure appears in the list of Infrastructures, indicating that the **dev01** Tenant is associated with Infrastructure **NONPROD**.<br>

   <figure><img src="/files/4wvxod2H9gzFVouIHRBT" alt=""><figcaption><p>Tenant list box with <strong>dev01</strong> selected; <strong>NONPROD</strong> Infrastructure with <strong>Status Complete</strong></p></figcaption></figure>


---

# 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:

```
GET https://docs.duplocloud.com/docs/automation-platform/overview-2/quick-start/step-2-tenant.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
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.
