# Add an ACI environment

Before connecting to your Azure subscription, you need to create an Azure AD application. For more information on this please refer to the [official Microsoft documentation](https://docs.microsoft.com/en-us/azure/active-directory/develop/howto-create-service-principal-portal).

{% hint style="info" %}
The following ACI features are not currently supported:

* ACI Persistent Storage
* Private networks
  {% endhint %}

To add an ACI environment, from the menu expand **Environment-related**, click **Environments**, then click **Add environment**.

<figure><img src="/files/g0rOtqS1Fmb7Nqv8xfrA" alt=""><figcaption></figcaption></figure>

Select **ACI** as your environment type and click **Start Wizard**. Enter the **environment details** using the table below as a guide.

| Field              | Overview                                                                                                                                                |
| ------------------ | ------------------------------------------------------------------------------------------------------------------------------------------------------- |
| Name               | Enter a name for your environment.                                                                                                                      |
| Application ID     | Enter the application ID for the app you created in your Azure account. This can be found on the **Overview** page of your app within the Azure Portal. |
| Tenant ID          | Enter the tenant ID for your app. This can be found on the **Overview** page of your app within the Azure Portal.                                       |
| Authentication Key | Enter the client secret for your app. This can be created under **Certificates & secrets** within your application in the Azure Portal.                 |

<figure><img src="/files/5bGmcIS56g1DlHWsRIYC" alt=""><figcaption></figcaption></figure>

As an optional step you can expand the **More settings** section and categorize the environment by adding it to a [group](/2.33-lts/admin/environments/groups.md) or [tagging](/2.33-lts/admin/environments/tags.md) it for better searchability.

<figure><img src="/files/Fbyqjz7GYdsTFWcxGTkm" alt=""><figcaption></figcaption></figure>

When you're ready, click **Connect**. If you have other environments to configure click **Next** to proceed, otherwise click **Close** to return to the list of environments.


---

# Agent Instructions: 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.portainer.io/2.33-lts/admin/environments/add/aci.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.