Files
podman/docs/source/markdown/podman-system-connection-list.1.md
Paul Holzinger 74454bf59c rework system connection and farm storage
We now no longer write containers.conf, instead system connections and
farms are written to a new file called podman-connections.conf.

This is a major rework and I had to change a lot of things to get this
to compile again with my c/common changes.

It is a breaking change for users as connections/farms added before this
commit can now no longer be removed or modified directly. However because
the logic keeps reading from containers.conf the old connections can
still be used to connect to a remote host.

Signed-off-by: Paul Holzinger <pholzing@redhat.com>
2024-01-31 15:08:41 +01:00

1.7 KiB

% podman-system-connection-list 1

NAME

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

SYNOPSIS

podman system connection list [options]

podman system connection ls [options]

DESCRIPTION

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

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
.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

$ 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

SEE ALSO

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

HISTORY

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