docker-credential-pass(1)

💖 docker-credential-pass(1) 💖

okay bestie, so this is a page from the Docker Credential Helpers manual — it's docker-credential-pass(1), and it's genuinely one of my faves. let's get into it 🫶

---

✨ NAME ✨

docker-credential-pass — store Docker credentials using pass 💅

---

✨ SYNOPSIS ✨

docker-credential-pass command

---

✨ DESCRIPTION ✨

so like. docker-credential-pass is a credential helper for the Docker engine, and it uses pass(1) as the credentials store. that means it lets Docker securely store and retrieve registry authentication credentials. slay 💖

⚠️ important bestie, do not skip this: pass needs to be configured for docker-credential-pass to work properly. it must be initialized with a gpg2 key ID. make sure your GPG key actually exists in the gpg2 keyring, because pass uses gpg2 and not the regular gpg. like, that's the whole vibe check right there. get it wrong and nothing works 😭

---

✨ COMMANDS ✨

• store — adds credentials to the store. the payload on standard input is a JSON document with ServerURL, Username and Secret. 📥
• get — retrieves credentials from the store. the payload on standard input is the raw value for the ServerURL. 📤
• erase — removes credentials from the store. the payload on standard input is the raw value for the ServerURL. 🗑️
• list — lists stored credentials. there is no standard input payload for this one. 📋
• version — prints the version of the credential helper. 🏷️

---

✨ CONFIGURATION ✨

to make Docker actually use this credential helper, you set the credsStore option in ~/.docker/config.json, like so:

{
  "credsStore": "pass"
}

that's it. that's the whole ritual. ✨🦋

---

✨ SEE ALSO ✨

docker-credential-secretservice(1), pass(1), docker(1)

---

and that's the page, bestie!! 💜 this one lives under the docker-credential-helpers umbrella, and it's the docker-credential-pass(1) manual — so go forth and keep those credentials cute and safe. periodt. 👑🎀🌸