oracular (1) docker-system-connection.1.gz

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)