From cec8c37a6fc517a64f1edbc968002f6d1edadc6c Mon Sep 17 00:00:00 2001
From: Mohith Shuka <mohithshuka@gmail.com>
Date: Tue, 17 Mar 2026 15:24:59 +0000
Subject: [PATCH 1/3] docs: clarify accepted syntax variants for security_opt

Document that security_opt accepts multiple syntax forms:
- option=value
- option:value
- bare option (for booleans like no-new-privileges)

Add examples showing all three equivalent forms for no-new-privileges.

Fixes https://github.com/docker/docs/issues/23958
---
 content/reference/compose-file/services.md | 11 +++++++++++
 1 file changed, 11 insertions(+)

diff --git a/content/reference/compose-file/services.md b/content/reference/compose-file/services.md
index 4c32080645b0..735039334364 100644
--- a/content/reference/compose-file/services.md
+++ b/content/reference/compose-file/services.md
@@ -1956,6 +1956,17 @@ secrets:
 
 `security_opt` overrides the default labeling scheme for each container.
 
+Options accept either `option=value` or `option:value` syntax. For boolean options
+such as `no-new-privileges`, the value may be omitted entirely, in which case the
+option is treated as enabled. The following syntaxes are all equivalent:
+
+```yml
+security_opt:
+  - no-new-privileges
+  - no-new-privileges=true
+  - no-new-privileges:true
+```
+
 ```yml
 security_opt:
   - label=user:USER

From 243efaae94ae418c013ad407073a310bb001a125 Mon Sep 17 00:00:00 2001
From: Mohith Shuka <mohithshuka@gmail.com>
Date: Wed, 18 Mar 2026 09:03:38 +0000
Subject: [PATCH 2/3] docs: add verify installation section to Linux Desktop
 install page

Closes #24138

- Added step-by-step verification using docker --version
- Added docker run hello-world to confirm end-to-end setup
- Added docker context ls to confirm desktop-linux context is active
---
 .../desktop/setup/install/linux/_index.md     | 31 +++++++++++++++++++
 1 file changed, 31 insertions(+)

diff --git a/content/manuals/desktop/setup/install/linux/_index.md b/content/manuals/desktop/setup/install/linux/_index.md
index 2d8ae96bfe96..2dc0bdfa1ad2 100644
--- a/content/manuals/desktop/setup/install/linux/_index.md
+++ b/content/manuals/desktop/setup/install/linux/_index.md
@@ -205,6 +205,37 @@ Sign out and sign back in so that your group membership is re-evaluated.
 
 Docker Desktop for Linux uses a per-user socket instead of the system-wide `/var/run/docker.sock`. Docker SDKs and tools that connect directly to the Docker daemon need the `DOCKER_HOST` environment variable set to connect to Docker Desktop. For configuration details, see [How do I use Docker SDKs with Docker Desktop for Linux?](/manuals/desktop/troubleshoot-and-support/faqs/linuxfaqs.md#how-do-i-use-docker-sdks-with-docker-desktop-for-linux).
 
+## Verify your installation
+
+After installing Docker Desktop, verify it is working correctly:
+
+1. Open a terminal and check the Docker version:
+```console
+   $ docker --version
+```
+
+   You should see output similar to:
+```
+   Docker version 27.x.x, build xxxxxxx
+```
+
+2. Run the hello-world container to confirm Docker Desktop is working end-to-end:
+```console
+   $ docker run hello-world
+```
+
+   If successful, you should see:
+```
+   Hello from Docker!
+   This message shows that your installation appears to be working correctly.
+```
+
+3. Check that Docker Desktop is using the correct context:
+```console
+   $ docker context ls
+```
+
+   The `desktop-linux` context should be marked with an asterisk (`*`) as the active context.
 ## Where to go next
 
 - Install Docker Desktop for Linux for your specific Linux distribution:

From e84541952e649cc4da02f11adc4761a0df3fff41 Mon Sep 17 00:00:00 2001
From: Mohith Shuka <mohithshuka@gmail.com>
Date: Wed, 18 Mar 2026 09:24:57 +0000
Subject: [PATCH 3/3] fix: correct markdownlint indentation in verify section

---
 content/manuals/desktop/setup/install/linux/_index.md | 7 ++++---
 1 file changed, 4 insertions(+), 3 deletions(-)

diff --git a/content/manuals/desktop/setup/install/linux/_index.md b/content/manuals/desktop/setup/install/linux/_index.md
index 2dc0bdfa1ad2..19f2b23527e3 100644
--- a/content/manuals/desktop/setup/install/linux/_index.md
+++ b/content/manuals/desktop/setup/install/linux/_index.md
@@ -215,11 +215,11 @@ After installing Docker Desktop, verify it is working correctly:
 ```
 
    You should see output similar to:
-```
+```text
    Docker version 27.x.x, build xxxxxxx
 ```
 
-2. Run the hello-world container to confirm Docker Desktop is working end-to-end:
+1. Run the hello-world container to confirm Docker Desktop is working end-to-end:
 ```console
    $ docker run hello-world
 ```
@@ -230,12 +230,13 @@ After installing Docker Desktop, verify it is working correctly:
    This message shows that your installation appears to be working correctly.
 ```
 
-3. Check that Docker Desktop is using the correct context:
+1. Check that Docker Desktop is using the correct context:
 ```console
    $ docker context ls
 ```
 
    The `desktop-linux` context should be marked with an asterisk (`*`) as the active context.
+
 ## Where to go next
 
 - Install Docker Desktop for Linux for your specific Linux distribution: