podman-logout(1)

💖 podman-logout(1) — the "bye bestie" command 💖

okay so real talk: this is the podman-logout page from the General Commands Manual, and it's literally just about logging out of a container registry. short page, big slay. let's get into it 🫶

---

✨ NAME ✨

podman-logout — log out of a container registry 👋

---

✨ SYNOPSIS ✨

podman logout [options] registry

---

✨ DESCRIPTION ✨

so what does podman logout actually do? it logs you out of a specified registry server by deleting the cached credentials stored in the auth.json file. bye credentials, it was fun 💅

if you don't specify the registry? no worries, it just uses the first registry under [registries.search] from registries.conf. defaults really said "i got you".

you can override the path of the authentication file yourself by setting the authfile flag. the default path it uses is:

${XDG_RUNTIME_DIR}/containers/auth.json

for more details about the format and configurations of the auth,json file, see containers-auth.json(5). and if you want to nuke all the cached credentials at once? just set the all flag and it's giving clean slate, no cap ✨

and here's the general shape of how you'd call it, global options included:

podman [GLOBAL OPTIONS]

podman logout [GLOBAL OPTIONS]

podman logout [OPTIONS] REGISTRY [GLOBAL OPTIONS]

---

✨ OPTIONS ✨

• --all, -a — remove the cached credentials for all registries in the auth file. full reset energy 🧹
• --authfile=path — path of the authentication file. the default is ${XDG_RUNTIME_DIR}/containers/auth.json on Linux, and $HOME/.config/containers/auth.json on Windows/macOS. this file gets created by podman login. if the authorization state isn't found there, $HOME/.docker/config.json gets checked instead, which is the one set using docker login.

📌 note bestie: there's also the option to override the default path of the authentication file by setting the REGISTRY_AUTH_FILE environment variable. you do that like this: export REGISTRY_AUTH_FILE=path.

• --compat-auth-file=path — instead of updating the default credentials file, update the one at path, and use a Docker-compatible format. so it's the same idea but ✨docker-flavored✨
• --help, -h — print usage statement. the classic. the icon 👑

---

✨ EXAMPLES ✨

remove login credentials for the docker.io registry from the authentication file:

$ podman logout docker.io

remove login credentials for the docker.io registry from the authdir/myauths.json file:

$ podman logout --authfile authdir/myauths.json docker.io

remove login credentials for all registries:

$ podman logout --all

---

✨ SEE ALSO ✨

podman(1), podman-login(1), containers-auth.json(5)

---

✨ HISTORY ✨

August 2017, originally compiled by Urvashi Mohnani umohnani@redhat.com ⟨mailto:umohnani@redhat.com⟩ 💜

---

and that's the whole page, bestie 🌸 this was podman-logout(1) from the General Commands Manual, compiled back in August 2017 — still serving useful after all these years, periodt 🎀 go log out of something, you deserve the clean slate ✨🦋