Configure Settings Management in Docker Home

{{< summary-bar feature_name="Admin Console" >}}

Use Docker Home to create and manage settings policies for Docker Desktop across your organization. Settings policies let you standardize configurations, enforce security requirements, and maintain consistent Docker Desktop environments.

Prerequisites#

Before you begin, make sure you have:

• Docker Desktop installed
• A verified domain
• Enforced sign-in for your organization
• A Docker Business subscription

[!IMPORTANT]

You can create settings management policies at any time, but your organization needs to verify a domain before the policies take effect.

Create a settings policy#

To create a new settings policy:

1. Sign in to Docker Home and select your organization.
2. Select Docker Desktop, then Settings Management.
3. Select Create a settings policy.
4. Provide a name and optional description.

[!TIP]

You can upload an existing admin-settings.json file to pre-fill the form. Docker Home policies override local admin-settings.json files.

1. Choose who the policy applies to: - All users - Specific users

   [!NOTE]

   User-specific policies override global default policies. Test your policy with a small group before applying it organization-wide.

2. Configure each setting using a state:

   Docker Home state	Description	admin-settings.json equivalent
   User-defined	Users can change the setting	Omit the setting
   Always enabled	Setting is on and locked	"value": true, "locked": true
   Enabled	Setting is on but can be changed	"value": true, "locked": false
   Always disabled	Setting is off and locked	"value": false, "locked": true
   Disabled	Setting is off but can be changed	"value": false, "locked": false

   [!TIP]

   For a complete list of configurable settings, supported platforms, and configuration methods, see the Settings reference.

3. Select Create to save your policy.

Apply the policy#

Settings policies take effect after Docker Desktop restarts and users sign in.

For new installations:

1. Launch Docker Desktop.
2. Sign in with your Docker account.

For existing installations:

1. Quit Docker Desktop completely.
2. Relaunch Docker Desktop.

[!IMPORTANT]

Users must fully quit and reopen Docker Desktop. Restarting from the Docker Desktop menu isn't sufficient.

Docker Desktop checks for policy updates when it launches and every 60 minutes while running.

Verify applied settings#

After you apply policies:

• Docker Desktop displays most settings as greyed out
• Some settings, particularly Enhanced Container Isolation configurations, may not appear in the GUI
• You can verify all applied settings by checking the settings-store.json file on your system

Manage existing policies#

From the Desktop Settings Management page in Docker Home, use the Actions menu to:

• Edit or delete an existing settings policy
• Export a settings policy as an admin-settings.json file
• Promote a user-specific policy to be the new global default

Roll back policies#

To roll back a settings policy:

• Complete rollback: Delete the entire policy.
• Partial rollback: Set specific settings to User-defined.

When you roll back settings, users regain control over those settings configurations.