podman-system-connection(1)

📦
version 6.1.4 · 5 versions
, in alpine 3.24, arch rolling, centos-stream 10, centos-stream 9, fedora 43, fedora 44, nixos 26.05, nixpkgs unstable, opensuse-leap 16.0, ubuntu resolute, ubuntu stonking

💅 podman-system-connection — bestie edition

okay so this is the podman-system-connection(1) page, straight outta the General Commands Manual, and it's literally the one that handles your Podman service destinations. let's get into it 🫶

✨ NAME ✨

podman-system-connection — manage the destination(s) for Podman service(s) 👑

🌸 SYNOPSIS 🌸

podman system connection subcommand

🦋 DESCRIPTION 🦋

So like, this command manages the destination(s) for Podman service(s). that's the whole vibe.

When you need to log in, the user gets prompted for the ssh login password or the key file passphrase as required. and yes, the ssh-agent is supported if it is running — so make sure it's up, bestie, or it's not gonna help you 😭

Podman manages the system connection by writing and reading the podman-connections.json file, which lives under $XDG_CONFIG_HOME/containers — or, if that env var isn't set, it defaults to $HOME/.config/containers. OR you can set the PODMAN_CONNECTIONS_CONF environment variable to a full file path, and podman will use that instead. slay, options ✨

🚨 real talk: this file is managed by the podman commands and should never be edited by users directly. no cap. if you want to manually configure the connections, use service_destinations in containers.conf instead. 💀

and one more thing — if the ReadWrite column in the podman system connection list output is set to true, that connection is stored in the podman-connections.json file. if it's not true, it's stored in containers.conf, which means it can therefore not be edited with the podman system connection commands. iykyk 🔥

👑 COMMANDS 👑

💜 EXAMPLE 💜

list system connections:

$ podman system connection list
Name URI                                           Identity       Default  ReadWrite
devl ssh://root@example.com/run/podman/podman.sock ~/.ssh/id_rsa  true     true

look at that output. immaculate. the Default and ReadWrite columns are both true, which is exactly the energy we're going for 💅

🌟 SEE ALSO 🌟

podman(1), podman-system(1)

go read those too, bestie, they're the whole ecosystem 🫶

📜 HISTORY 📜

June 2020, originally compiled by Jhon Honce (jhonce at redhat dot com). iconic of him honestly 🍓

and that's a wrap!! this was podman-system-connection(1) from the General Commands Manual, dated back to June 2020 — mwah, no notes, periodt 💖✨🦋

📦 where this page comes from