> 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/sts/admin/environments/policies/docker-policies/setup-policy.md).

# Create a Docker, Swarm or Podman setup policy

Define a policy by configuring cluster settings, resources, and deployment options for Docker, Swarm or Podman environments.

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

{% hint style="info" %}
Currently, only custom setup 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>                      |
| Enable host management features                                      | Enabling host management features allows you to see the available devices and storage on the physical node as well as browse the node's filesystem. Further details of this can be seen in the [host setup documentation](/sts/user/docker/host/setup.md). |
| Enable volume management for non-administrators                      | Enabling this feature allows non-administrator users to manage volumes on an environment. If this is disabled, users below administrator level have read-only access to volumes.                                                                           |
| Show GPU in the UI                                                   | Toggle on to enable GPU assignments in the Portainer UI. This adds additional processing to the container and stack listing pages, so if you are not using GPUs on your environment we recommend toggling this off.                                        |
| Add GPU                                                              | When **Show GPU in the UI** is toggled on, click Add GPU to add GPUs to your environment for use by your containers. To add a GPU, provide a name for the GPU and an index or UUID to reference the GPU.                                                   |
| Show image up to date indicators for Stacks, Services and Containers | Toggle on to enable the [new image indicator ](/sts/user/docker/containers.md)feature for this environment.                                                                                                                                                |
| Enable Change Window                                                 | This setting allows you to specify a window within which [GitOps updates](/sts/user/kubernetes/applications/manifest/create.md#gitops-updates) to your applications can be applied.                                                                        |

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

When you have completed the form, 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.


---

# 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, and the optional `goal` query parameter:

```
GET https://docs.portainer.io/sts/admin/environments/policies/docker-policies/setup-policy.md?ask=<question>&goal=<endgoal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is optional and describes the broader end goal you are ultimately trying to accomplish on behalf of the user. GitBook uses it to tailor the answer towards what is most useful for that goal.

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.