podman-system-connection(1) General Commands Manual podman-system-connection(1)

# [NAME](#NAME)

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

# [SYNOPSIS](#SYNOPSIS)

**podman system connection** *subcommand*

# [DESCRIPTION](#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](#COMMANDS)

**Command** **Man Page** **Description** add [podman-system-connection-add(1)](/man/enterprise-packages/podman-doc-6.0/podman-system-connection-add.1) Record destination for the Podman service default [podman-system-connection-default(1)](/man/enterprise-packages/podman-doc-6.0/podman-system-connection-default.1) Set named destination as default for the Podman service list [podman-system-connection-list(1)](/man/enterprise-packages/podman-doc-6.0/podman-system-connection-list.1) List the destination for the Podman service(s) remove [podman-system-connection-remove(1)](/man/enterprise-packages/podman-doc-6.0/podman-system-connection-remove.1) Delete named destination rename [podman-system-connection-rename(1)](/man/enterprise-packages/podman-doc-6.0/podman-system-connection-rename.1) Rename the destination for Podman service

# [EXAMPLE](#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](#SEE_ALSO)

[**podman(1)**](/man/enterprise-packages/podman-doc-6.0/podman.1), [**podman-system(1)**](/man/enterprise-packages/podman-doc-6.0/podman-system.1)

# [HISTORY](#HISTORY)

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

---

Document: podman-system-connection(1) from podman-doc-6.0 6.0.2-r13 (Chainguard OS)
Source: https://github.com/containers/podman