podman-system-connection - Manage the destination(s) for Podman service(s)
Contents
Commands
┌─────────┬─────────────────────────────────────┬──────────────────────────────┐
│ Command │ ManPage │ Description │
├─────────┼─────────────────────────────────────┼──────────────────────────────┤
│ add │ podman-system-connection-add(1) │ Record destination for the │
│ │ │ Podman service │
├─────────┼─────────────────────────────────────┼──────────────────────────────┤
│ default │ podman-system-connection-default(1) │ Set named destination as │
│ │ │ default for the Podman │
│ │ │ service │
├─────────┼─────────────────────────────────────┼──────────────────────────────┤
│ list │ podman-system-connection-list(1) │ List the destination for the │
│ │ │ Podman service(s) │
├─────────┼─────────────────────────────────────┼──────────────────────────────┤
│ remove │ podman-system-connection-remove(1) │ Delete named destination │
├─────────┼─────────────────────────────────────┼──────────────────────────────┤
│ rename │ podman-system-connection-rename(1) │ Rename the destination for │
│ │ │ Podman service │
└─────────┴─────────────────────────────────────┴──────────────────────────────┘
Description
Manage the destination(s) for Podman service(s).
The user is prompted for the ssh login password or key file passphrase as required. The ssh-agent is
supported if it is running.
Podman manages the system connection by writing and reading the podman-connections.json file located
under $XDG_CONFIG_HOME/containers or if the env is not set it defaults to $HOME/.config/containers. Or
the PODMAN_CONNECTIONS_CONF environment variable can be set to a full file path which podman will use
instead. This file is managed by the podman commands and should never be edited by users directly. To
manually configure the connections use service_destinations in containers.conf.
If the ReadWrite column in the podmansystemconnectionlist output is set to true the connection is
stored in the podman-connections.json file otherwise it is stored in containers.conf and can therefore
not be edited with the podmansystemconnection 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
History
June 2020, Originally compiled by Jhon Honce (jhonce at redhat dot com)
podman-system-connection(1)
Name
podman-system-connection - Manage the destination(s) for Podman service(s)
See Also
podman(1), podman-system(1)
Synopsis
podmansystemconnectionsubcommand
