opensource/podman
1
0
Fork 0
mirror of https://github.com/containers/podman.git synced 2025-05-20 00:27:03 +08:00
Code Issues Packages Projects Releases Wiki Activity
Files
podman/docs/source/markdown/podman-system-connection.1.md
Paul Holzinger dc0d07c71f document new connection/farm storage location 
The new file was not really documented, so leave some pointers on how it
works and that the new file should not be edited manually.

Signed-off-by: Paul Holzinger <pholzing@redhat.com>
2024-02-08 18:05:32 +01:00

2.6 KiB
Raw Blame History

% podman-system-connection 1

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

$ 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)