67 lines
1.9 KiB
Groff
67 lines
1.9 KiB
Groff
.nh
|
|
.TH podman-system-connection-add 1
|
|
.SH NAME
|
|
podman-system-connection-add \- Record destination for the Podman service
|
|
|
|
.SH SYNOPSIS
|
|
\fBpodman system connection add\fP [\fIoptions\fP] \fIname\fP \fIdestination\fP
|
|
|
|
.SH DESCRIPTION
|
|
Record ssh destination for remote podman service(s). The ssh destination is given as one of:
|
|
- [user@]hostname[:port]
|
|
- ssh://[user@]hostname[:port]
|
|
- unix://path
|
|
- tcp://hostname:port
|
|
|
|
.PP
|
|
The user is prompted for the remote ssh login password or key file passphrase as required. The \fBssh-agent\fR is supported if it is running.
|
|
|
|
.SH OPTIONS
|
|
.SS \fB--default\fP, \fB-d\fP
|
|
Make the new destination the default for this user. The default is \fBfalse\fP\&.
|
|
|
|
.SS \fB--identity\fP=\fIpath\fP
|
|
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.
|
|
|
|
.SS \fB--port\fP, \fB-p\fP=\fIport\fP
|
|
Port for ssh destination. The default value is \fB22\fR\&.
|
|
|
|
.SS \fB--socket-path\fP=\fIpath\fP
|
|
Path to the Podman service unix domain socket on the ssh destination host
|
|
|
|
.SH EXAMPLE
|
|
Add a named system connection:
|
|
|
|
.EX
|
|
$ podman system connection add QA podman.example.com
|
|
.EE
|
|
|
|
.PP
|
|
Add a system connection using SSH data:
|
|
|
|
.EX
|
|
$ podman system connection add --identity ~/.ssh/dev_rsa production ssh://root@server.example.com:2222
|
|
.EE
|
|
|
|
.PP
|
|
Add a named system connection to local Unix domain socket:
|
|
|
|
.EX
|
|
$ podman system connection add testing unix:///run/podman/podman.sock
|
|
.EE
|
|
|
|
.PP
|
|
Add a named system connection to local tcp socket:
|
|
|
|
.EX
|
|
$ podman system connection add debug tcp://localhost:8080
|
|
.EE
|
|
|
|
.SH SEE ALSO
|
|
\fBpodman(1)\fP, \fBpodman-system(1)\fP, \fBpodman-system-connection(1)\fP
|
|
|
|
.SH HISTORY
|
|
June 2020, Originally compiled by Jhon Honce (jhonce at redhat dot com)
|