summaryrefslogtreecommitdiff
path: root/docs/source/markdown/podman-system-connection.1.md
blob: 66cb656ae82db813a2d8a57abf7f7df7b6021560 (plain)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
% podman-system-connection(1)

## NAME
podman\-system\-connection - Record ssh destination for remote podman service

## SYNOPSIS
**podman system connection** [*options*] [*ssh destination*]

## DESCRIPTION
Record ssh destination for remote podman service(s). The ssh destination is given as one of:
 - [user@]hostname[:port]
 - ssh://[user@]hostname[:port]

The user will be prompted for the remote ssh login password or key file pass phrase as required. `ssh-agent` is supported if it is running.

## OPTIONS

**--identity**=*path*

Path to ssh identity file. If the identity file has been encrypted, Podman prompts the user for the passphrase.
If no identity file is provided and no user is given, Podman defaults to the user running the podman command.
Podman prompts for the login password on the remote server.

**-p**, **--port**=*port*

Port for ssh destination. The default value is `22`.

**--socket-path**=*path*

Path to podman service unix domain socket on the ssh destination host

## EXAMPLE
```
$ podman system connection podman.fubar.com

$ podman system connection --identity ~/.ssh/dev_rsa ssh://root@server.fubar.com:2222

```
## SEE ALSO
podman-system(1) , containers.conf(5) , connections.conf(5)

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