.TH "podman-remote.conf" "5" "" 
.nh
.ad l

.SH NAME
.PP
podman\-remote.conf \- configuration file for the podman remote client

.SH DESCRIPTION
.PP
The libpod.conf file is the default configuration file for all tools using
libpod to manage containers.

.PP
The podman\-remote.conf file is the default configuration file for the podman
remote client.  It is in the TOML format.  It is primarily used to keep track
of the user's remote connections.

.SH CONNECTION OPTIONS
.PP
\fBdestination\fP = ""
  The hostname or IP address of the remote system

.PP
\fBusername\fP = ""
  The username to use when connecting to the remote system

.PP
\fBdefault\fP = bool
  Denotes whether the connection is the default connection for the user.  The default connection
  is used when the user does not specify a destination or connection name to \fB\fCpodman\fR\&.

.PP
\fBport\fP = int
  Use an alternative port for the ssh connections.  The default port is 22.

.PP
\fBidentity\_file\fP = ""
  Use an alternative location for the ssh private key

.PP
\fBignore\_hosts\fP = bool
  Don't match the remote ssh host key with known hosts

.SH EXAMPLE
.PP
The following example depicts a configuration file with two connections.  One of the connections
is designated as the default connection.

.PP
.RS

.nf
[connections]
    [connections.host1]
    destination = "host1"
    username = "homer"
    default = true

    [connections.host2]
    destination = "192.168.122.133"
    username = "fedora"
    port = 2222

.fi
.RE

.SH FILES
.PP
\fB\fC/$HOME/.config/containers/podman\-remote.conf\fR, default location for the podman remote
configuration file

.SH HISTORY
.PP
May 2019, Originally compiled by Brent Baude
\[la]bbaude@redhat.com\[ra]