> For the complete documentation index, see [llms.txt](https://docs.portainer.io/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.portainer.io/admin/environments/policies/docker-policies/registry-policy.md).

# Create a Docker, Swarm or Podman registry policy

Define a policy by managing registry access and configuration for Kubernetes clusters.

To create a registry policy, in the menu, under **Environment-related**, select **Policies** then select **Create policy**. From the policy type list, navigate to the **Docker** > **Registry** section, select **Custom** then select **Continue** to begin configuring the policy.

{% hint style="info" %}
Currently, only custom registry policies can be created. Future improvements to the policies feature will introduce policy templates.
{% endhint %}

| Field/Option              | Overview                                                                                                                                                                                                                              |
| ------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| Name                      | Define a name for this policy.                                                                                                                                                                                                        |
| Environment groups        | <p>Select one or more environment <a href="/pages/-MgcuVpHfggt_wDn_a0N">groups</a> from the dropdown menu.<br>If the selected group is already included in an existing policy, a warning icon will appear next to the group name.</p> |
| Select registry           | ​Select a [registry](/user/kubernetes/cluster/registries.md) from the dropdown menu. ​                                                                                                                                                |
| Select users and/or teams | Select one or more [user](/admin/user/users.md) or [team](/admin/user/teams.md) that you want to have access to the selected registry.                                                                                                |

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

Click **Add Access** to add the registry to the access list, multiple entries can be added. Each access added will show in the **Registry access list**. When you have finished adding access, click **Create policy**. A confirmation screen displays the changes being made and any existing policy that will be replaced. Click **Confirm** to acknowledge the changes and create the policy.