Home Explore Blog CI



docker

content/manuals/scout/policy/configure.md
e3f4be5c1cc020669c8b710e4db70407d15a0f2177f85ab60000000300000e8f
---
title: Configure policies
description: Learn how to configure, disable, or delete policies in Docker Scout
keywords: scout, policy, configure, delete, enable, parametrize, thresholds
---

Some policy types are configurable. This means that you can create new,
customized version of that policy type with your own configuration parameters.
You can also disable a policy if you need to temporarily disregard it, or
delete a policy altogether if it doesn't match your needs.

> [!NOTE]
> Historic evaluation results for the default policy configuration are removed
> if you delete or customize a policy.

## Add a policy

To add a new policy, select the policy type that you want to customize. All
custom policies use a policy type as a base.

You can edit the display name and description of the new policy to help
better communicate the compliant and non-compliant states of the policy.
You can not change the name of the policy type, only its display names.

The available configuration parameters for a policy depends on the
policy type that you're editing. For more information, refer to
[Policy types](/manuals/scout/policy/_index.md#policy-types).

To add a policy:

1. Go to the [Policies page](https://scout.docker.com/reports/policy) in the Docker Scout Dashboard.
2. Select the **Add policy** button to open the policy configuration screen.
3. On the policy configuration screen, locate the policy type that you want to
   configure, and select **Configure** to open the policy configuration page.

   - If the **Configure** button is grayed out, it means the current policy
     has no configurable parameters.
   - If the button reads **Integrate**, it indicates that setup is required
     before the policy can be enabled. Selecting **Integrate** will direct you
     to the integration's setup guide.

4. Update the policy parameters.
5. Save the changes:

   - Select **Save policy** to commit the changes and enable the policy for
     your current organization.
   - Select **Save and disable** to save the policy configuration without enabling
     it.

## Edit a policy

Editing a policy lets you to modify its configuration without creating 
a new one from scratch. This can be useful when policy parameters need adjustments 
due to evolving requirements or changes in your organization's compliance goals.

To edit a policy:

1. Go to the [Policies page](https://scout.docker.com/reports/policy) in the Docker Scout Dashboard.
2. Select the policy you want to edit.
3. Select the **Edit** button.
4. Update the policy parameters.
5. Save the changes.

## Disable a policy

When you disable a policy, evaluation results for that policy are hidden, and
no longer appear in the Docker Scout Dashboard or in the CLI. Historic
evaluation results aren't deleted if you disable a policy, so if you change
your mind and re-enable a policy later, results from earlier evaluations will
still be available.

To disable a policy:

1. Go to the [Policies page](https://scout.docker.com/reports/policy) in the Docker Scout Dashboard.
2. Select the policy you want to disable.
3. Select the **Disable** button.

## Delete a policy

When you delete a policy, evaluation results for that policy are deleted as
well, and no longer appear in the Docker Scout Dashboard or in the CLI.

To delete a policy:

1. Go to the [Policies page](https://scout.docker.com/reports/policy) in the Docker Scout Dashboard.
2. Select the policy you want to delete.
3. Select the **Delete** button.

## Recover a deleted policy

If you've deleted a policy, you can recreate it by following the steps in [Add
a policy](#add-a-policy). On the policy configuration screen, select
**Configure** on the deleted policy that you wish to recreate.

Chunks
54c12ce3 (1st chunk of `content/manuals/scout/policy/configure.md`)
Title: Configuring, Editing, Disabling, and Deleting Policies in Docker Scout
Summary
This section explains how to configure, edit, disable, and delete policies in Docker Scout. Configurable policies can be customized, disabled temporarily, or deleted if not needed. Adding a policy involves selecting a policy type to customize, editing its display name and description, and adjusting configuration parameters. Editing a policy allows modifications to its configuration without creating a new one. Disabling a policy hides its evaluation results without deleting them, while deleting a policy removes its evaluation results entirely. Deleted policies can be recreated.