From ddf805714452d0bbdc972c10b5e77eec0d9b2f80 Mon Sep 17 00:00:00 2001
From: Dean Chen <51218137+locker95@users.noreply.github.com>
Date: Wed, 12 Aug 2026 09:27:55 +0500
Subject: [PATCH] docs: note docker login secrets service failures on Linux

Headless hosts without org.freedesktop.secrets hit a hard-to-decode
error; point at pass or config.json fallback.

Related to docker/cli#7148

Signed-off-by: Dean Chen <862469039@qq.com>
---
 data/cli/engine/docker_login.yaml | 7 +++++++
 1 file changed, 7 insertions(+)

diff --git a/data/cli/engine/docker_login.yaml b/data/cli/engine/docker_login.yaml
index 96f9545b230d..19357820f2f5 100644
--- a/data/cli/engine/docker_login.yaml
+++ b/data/cli/engine/docker_login.yaml
@@ -50,6 +50,13 @@ long: |-
     - Microsoft Windows Credential Manager
     - [pass](https://www.passwordstore.org/)
 
+    On headless Linux hosts, D-Bus Secret Service often fails with errors like
+    `The name org.freedesktop.secrets was not provided by any .service files`
+    when no secret service is running. Install and start a secret service, or
+    switch `credsStore` to `pass` (after setting up
+    [pass](https://www.passwordstore.org/)), or remove `credsStore` so
+    credentials fall back to `config.json` (less secure, but works offline).
+
     With Docker Desktop, the credential store is already installed and configured
     for you. Unless you want to change the credential store used by Docker Desktop,
     you can skip the following steps.