aboutsummaryrefslogtreecommitdiff
path: root/docs/podman-create.1.md
diff options
context:
space:
mode:
authorDaniel J Walsh <dwalsh@redhat.com>2019-07-11 09:25:38 -0400
committerDaniel J Walsh <dwalsh@redhat.com>2019-07-11 13:25:47 -0400
commitdf75fc62c8316bce058bbdda29f66af9dcc5573a (patch)
tree88d3cddc663a057c14b9f9b65707cb3d2f6c1def /docs/podman-create.1.md
parent144567b42dba2c8c426538a4b5fe7d718b43284a (diff)
downloadpodman-df75fc62c8316bce058bbdda29f66af9dcc5573a.tar.gz
podman-df75fc62c8316bce058bbdda29f66af9dcc5573a.tar.bz2
podman-df75fc62c8316bce058bbdda29f66af9dcc5573a.zip
Add support for -env-host
This flag passes the host environment into the container. The basic idea is to leak all environment variables from the host into the container. Environment variables from the image, and passed in via --env and --env-file will override the host environment. Signed-off-by: Daniel J Walsh <dwalsh@redhat.com>
Diffstat (limited to 'docs/podman-create.1.md')
-rw-r--r--docs/podman-create.1.md23
1 files changed, 19 insertions, 4 deletions
diff --git a/docs/podman-create.1.md b/docs/podman-create.1.md
index 9cf3e038d..00b706d4a 100644
--- a/docs/podman-create.1.md
+++ b/docs/podman-create.1.md
@@ -245,13 +245,15 @@ You need to specify multi option commands in the form of a json string.
Set environment variables
-This option allows you to specify arbitrary
-environment variables that are available for the process that will be launched
-inside of the container.
+This option allows you to specify arbitrary environment variables that are available for the process that will be launched inside of the container. If you specify a environment variable without a value, podman will check the host environment for a value or set the environment to "". See **Environment** note below for precedence.
+
+**--env-host**=*true|false*
+
+Use host environment inside of the container. See **Environment** note below for precedence.
**--env-file**=*file*
-Read in a line delimited file of environment variables
+Read in a line delimited file of environment variables. See **Environment** note below for precedence.
**--expose**=*port*
@@ -901,6 +903,19 @@ The fuse-overlay package provides a userspace overlay storage driver, otherwise
the vfs storage driver, which is diskspace expensive and does not perform well. slirp4netns is
required for VPN, without it containers need to be run with the --net=host flag.
+## ENVIRONMENT
+
+Environment variables within containers can be set using multiple different options: This section describes the presidence.
+
+Presidence Order:
+ **--env-host** : Host environment of the process executing podman is added.
+
+ Container image : Any enviroment variables specified in the contianer image.
+
+ **--env-file** : Any environment variables specfied via env-files. If multiple files specified, then they override each other in order of entry.
+
+ **--env** : Any environment variables specified will overide previous settings.
+
## FILES
**/etc/subuid**