podman-system-connection-list(1) General Commands Manual podman-system-connection-list(1)

# [NAME](#NAME)

podman-system-connection-list - List the destination for the Podman service(s)

# [SYNOPSIS](#SYNOPSIS)

**podman system connection list** \[*options*]

**podman system connection ls** \[*options*]

# [DESCRIPTION](#DESCRIPTION)

List ssh destination(s) for podman service(s).

# [OPTIONS](#OPTIONS)

## **--format**, **-f**=*format*

Change the default output format. This can be of a supported type like 'json' or a Go template. Valid placeholders for the Go template listed below:

**Placeholder** **Description** .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

# [EXAMPLE](#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
---
```

# [SEE ALSO](#SEE_ALSO)

[**podman(1)**](/man/os/podman-doc-6.0/podman.1), [**podman-system(1)**](/man/os/podman-doc-6.0/podman-system.1), [**podman-system-connection(1)**](/man/os/podman-doc-6.0/podman-system-connection.1)

# [HISTORY](#HISTORY)

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

---

Document: podman-system-connection-list(1) from podman-doc-6.0 6.0.2-r2 (Chainguard OS)
Source: https://github.com/containers/podman