summaryrefslogtreecommitdiff
path: root/docs
diff options
context:
space:
mode:
authorOpenShift Merge Robot <openshift-merge-robot@users.noreply.github.com>2019-06-04 20:02:01 +0200
committerGitHub <noreply@github.com>2019-06-04 20:02:01 +0200
commit3fb9669a63558955766e7bd9152b8b542b00d9dd (patch)
tree1a714fe12c96023f390592f3d93501102d6fd72a /docs
parent2a4e5aac197d86c836d9026e97b089744cc609c5 (diff)
parentdc7ae3117146aa4e91d454b4b1afa03058638b13 (diff)
downloadpodman-3fb9669a63558955766e7bd9152b8b542b00d9dd.tar.gz
podman-3fb9669a63558955766e7bd9152b8b542b00d9dd.tar.bz2
podman-3fb9669a63558955766e7bd9152b8b542b00d9dd.zip
Merge pull request #3231 from baude/remoteclientconf
podman-remote.conf enablement
Diffstat (limited to 'docs')
-rw-r--r--docs/podman-remote.conf.5.md47
1 files changed, 47 insertions, 0 deletions
diff --git a/docs/podman-remote.conf.5.md b/docs/podman-remote.conf.5.md
new file mode 100644
index 000000000..3e1cffb02
--- /dev/null
+++ b/docs/podman-remote.conf.5.md
@@ -0,0 +1,47 @@
+% 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`.
+
+
+## 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"
+```
+
+## 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>