# Add a new namespace

From the menu select **Namespaces** then click **Add with form**.

{% hint style="info" %}
Namespaces can also be added [using a manifest](https://docs.portainer.io/2.33-lts/user/kubernetes/applications/manifest) by clicking **Create from manifest**.
{% endhint %}

<figure><img src="https://3850702872-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FXI7douejaBgpZ6CP2zJf%2Fuploads%2Fgit-blob-ccbd3790a9b98c448b9b2c7fdab7b508a70db4ec%2F2.20-namespaces-add.gif?alt=media" alt=""><figcaption></figcaption></figure>

Give the namespace a descriptive **name**. As an optional step you can add annotations to your namespace as required by clicking **Add annotation** and filling in the **Key** and **Value** fields.&#x20;

<figure><img src="https://3850702872-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FXI7douejaBgpZ6CP2zJf%2Fuploads%2Fgit-blob-e5f74701eaa5aacb4a343b401e1dcfad4ca3ac4f%2F2.18-k8s-namespaces-add-name.png?alt=media" alt=""><figcaption></figcaption></figure>

### Resource quota

You can assign a quota by toggling **Resource assignment** on, then setting resource limits like how much memory and CPU will be assigned.

<figure><img src="https://3850702872-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FXI7douejaBgpZ6CP2zJf%2Fuploads%2Fgit-blob-0e144b8ddbbf8d514dd44c60e2cdc7c1cbd4aa10%2F2.20-kubernetes-namespaces-add-resourcequota.png?alt=media" alt=""><figcaption></figcaption></figure>

### Load balancers

To set a maximum number of external load balancers that can be created inside the namespace, toggle on **Load Balancer quota** and set the **Max Load Balancers** number. If Load Balancer quota is enabled and the Max Load Balancers value is set to `0`, the use of external load balancers is effectively disabled in the namespace.

{% hint style="info" %}
This section is only visible when **Allow users to use external load balancers** is enabled in the [Cluster Setup](https://docs.portainer.io/2.33-lts/user/cluster/setup#allow-users-to-use-external-load-balancer).
{% endhint %}

<figure><img src="https://3850702872-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FXI7douejaBgpZ6CP2zJf%2Fuploads%2Fgit-blob-fee4d5ae88da692d7bfb03830ed5b706c2400a60%2F2.18-k8s-namespaces-add-lbquota.png?alt=media" alt=""><figcaption></figcaption></figure>

### Networking - Ingresses

This section lets you define which ingress controllers are allowed to be used to publish applications within this namespace. Check the boxes next to the ingresses you want to allow and click **Allow selected**, or click **Disallow selected** to disallow their use in this namespace.

{% hint style="info" %}
This section is only visible when **Configure ingress controller availability per namespace** is enabled in the [Cluster Setup](https://docs.portainer.io/2.33-lts/user/cluster/setup#networking-ingresses).
{% endhint %}

<figure><img src="https://3850702872-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FXI7douejaBgpZ6CP2zJf%2Fuploads%2Fgit-blob-cc3462d92aec8c97bb3eb69a269fb0875bc3b531%2F2.20-namespaces-add-ingress.png?alt=media" alt=""><figcaption></figcaption></figure>

### Registries

You can define the registries that are available within this namespace in this section. Select the registries from the **Select registries** dropdown to allow access.

<figure><img src="https://3850702872-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FXI7douejaBgpZ6CP2zJf%2Fuploads%2Fgit-blob-310b450370dc7aef10a4e987c72d6631fab63e52%2F2.18-k8s-namespaces-add-registries.png?alt=media" alt=""><figcaption></figcaption></figure>

### Storage

Use this section to enable quotas on your storage options for this namespace. To enable the use of quotas on a storage option, toggle **Enable quota** to on and set the **Maximum usage**. A Maximum usage value of `0` effectively prevents the usage of that storage option within the namespace.&#x20;

<figure><img src="https://3850702872-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FXI7douejaBgpZ6CP2zJf%2Fuploads%2Fgit-blob-b0c562df22e538e33caca2097722464a374577a8%2F2.18-k8s-namespaces-add-storage.png?alt=media" alt=""><figcaption></figcaption></figure>

### Summary

This section displays a summary of the actions that will be taken when clicking the Add namespace button.&#x20;

<figure><img src="https://3850702872-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FXI7douejaBgpZ6CP2zJf%2Fuploads%2Fgit-blob-2788f3af22a122cad4c5bf1a99d16537d58e3458%2F2.18-k8s-namespaces-add-summary.png?alt=media" alt=""><figcaption></figcaption></figure>

When you're finished, click **Create namespace**.