summaryrefslogtreecommitdiff
path: root/docs/source/markdown/podman-remote.conf.5.md
blob: e9cc05989b9cf4615fd0ece0ecebb98b6334f49f (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
44
45
46
47
48
49
50
51
52
53
54
55
56
57
% podman-remote.conf(5)

## NAME
podman-remote.conf - configuration file for the podman remote client

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

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.

## CONNECTION OPTIONS
**destination** = ""
  The hostname or IP address of the remote system

**username** = ""
  The username to use when connecting to the remote system

**default** = 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 `podman`.

**port** = int
  Use an alternative port for the ssh connections.  The default port is 22.

**identity_file** = ""
  Use an alternative location for the ssh private key

**ignore_hosts** = bool
  Don't match the remote ssh host key with known hosts


## EXAMPLE

The following example depicts a configuration file with two connections.  One of the connections
is designated as the default connection.
```
[connections]
    [connections.host1]
    destination = "host1"
    username = "homer"
    default = true

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

## FILES
  `/$HOME/.config/containers/podman-remote.conf`, default location for the podman remote
configuration file

## HISTORY
May 2019, Originally compiled by Brent Baude<bbaude@redhat.com>