podman-sys...ection-list(1)

💖 podman-system-connection-list(1) 💖

okay bestie, welcome to the General Commands Manual entry for podman-system-connection-list — yes that's a long name, yes the terminal chops it up, we move. grab a strawberry 🍓 and let's get into it.

---

✨ NAME ✨

podman-system-connection-list — bestie, this is the one that lists the destination for the Podman service(s). that's it. that's the job. 💅

---

🌸 SYNOPSIS 🌸

podman system connection list [options]

podman system connection ls [options]

yes ls is right there too, we love a short king 👑

---

🦋 DESCRIPTION 🦋

it lists the ssh destination(s) for the podman service(s). no cap, that's the whole vibe check. 💖

---

👑 OPTIONS 👑

• --format, -f=format — okay so this one changes the default output format. it can be a supported type like 'json' or a Go template. if you go the Go template route, here are the valid placeholders, and you're gonna want to screenshot this 📸:
  • .Default — Indicates whether connection is the default
  • .Identity — Path to file containing SSH identity
  • .Name — Connection Name/Identifier
  • .ReadWrite — Indicates if this connection can be modified using the system connection commands
  • .TLSCA — Path to a PEM file containing the certificate authority bundle to verify the server's certificate against.
  • .TLSCert — Path to a PEM file containing the certificate authority bundle to verify the server's certificate against.
  • .TLSKey — Path to a PEM file containing the private key matching .TLSCA
  • .URI — URI to podman service. Valid schemes are ssh://[user@]host[:port]Unix domain socket[?secure=True], unix://Unix domain socket, and tcp://localhost[:port]
• --quiet, -q — Only show connection names. minimal. chic. lowkey obsessed. 🎀

---

🌈 EXAMPLE 🌈

List system connections:

$ podman system connection list
Name URI                                                      Identity         Default  ReadWrite
deva ssh://root@example.com:/run/podman/podman.sock           ~/.ssh/id_rsa true     true
devb ssh://user@example.com:/run/user/1000/podman/podman.sock ~/.ssh/id_rsa false    true

Show connections in JSON format:

$ podman system connection list --format json
[
    {
        "Name": "podman-machine-default",
        "URI": "ssh://core@127.0.0.1:53298/run/user/501/podman/podman.sock",
        "Identity": "/Users/ragm/.local/share/containers/podman/machine/machine",
        "IsMachine": true,
        "Default": true,
        "ReadWrite": true
    },
    {
        "Name": "podman-machine-default-root",
        "URI": "ssh://root@127.0.0.1:53298/run/podman/podman.sock",
        "Identity": "/Users/ragm/.local/share/containers/podman/machine/machine",
        "IsMachine": true,
        "Default": false,
        "ReadWrite": true
    }
]

Show connection names and URIs:

$ podman system connection list --format "{{.Name}}\t{{.URI}}"
podman-machine-default   ssh://core@127.0.0.1:53298/run/user/501/podman/podman.sock
podman-machine-default-root   ssh://root@127.0.0.1:53298/run/podman/podman.sock

Show all connection details in a comprehensive format:

$ podman system connection list --format "Name: {{.Name}}\nURI: {{.URI}}\nIdentity: {{.Identity}}\nDefault: {{.Default}}\nReadWrite: {{.ReadWrite}}\n---"
Name: podman-machine-default
URI: ssh://core@127.0.0.1:53298/run/user/501/podman/podman.sock
Identity: /Users/ragm/.local/share/containers/podman/machine/machine
Default: true
ReadWrite: true
---
Name: podman-machine-default-root
URI: ssh://root@127.0.0.1:53298/run/podman/podman.sock
Identity: /Users/ragm/.local/share/containers/podman/machine/machine
Default: false
ReadWrite: true
---

like?? the range?? the template game is unmatched fr fr 🔥

---

💜 SEE ALSO 💜

podman(1), podman-system(1), podman-system-connection(1)

go read those too, they're the supporting cast and they ate 💅

---

📜 HISTORY 📜

July 2020, Originally compiled by Jhon Honce (jhonce at redhat dot com)

---

and that's the whole page bestie!! this one lives in the General Commands Manual as podman-sys...ection-list(1) — yes the truncation is giving chaos, iykyk 😭 — and that's a wrap on the July 2020 era. mwah, go list some connections, you're the main character now 🫶✨💖