podman-system-connection(1)                            General Commands Manual

NAME
       podman-system-connection - Manage the destination(s) for Podman
       service(s)


SYNOPSIS
       podman system connection subcommand


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 podman system connection list 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 podman system connection commands.


COMMANDS

       +--------+-------------------------------------+--------------------------+
       |Command | Man Page                            | 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       |
       +--------+-------------------------------------+--------------------------+

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



SEE ALSO
       podman(1), podman-system(1)


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

                                                   podman-system-connection(1)