hugo/docs/content/en/functions/getenv.md
2022-11-17 16:16:19 +01:00

1 KiB

title description date publishdate lastmod categories menu keywords signature workson hugoversion relatedfuncs deprecated aliases
getenv Returns the value of an environment variable, or an empty string if the environment variable is not set. 2017-02-01 2017-02-01 2021-11-26
functions
docs
parent
functions
os.Getenv VARIABLE
getenv VARIABLE
false

Examples:

{{ os.Getenv "HOME" }} --> /home/victor
{{ os.Getenv "USER" }} --> victor

You can pass values when building your site:

MY_VAR1=foo MY_VAR2=bar hugo

OR

export MY_VAR1=foo
export MY_VAR2=bar
hugo

And then retrieve the values within a template:

{{ os.Getenv "MY_VAR1" }} --> foo
{{ os.Getenv "MY_VAR2" }} --> bar

With Hugo v0.91.0 and later, you must explicitly allow access to environment variables. For details, review Hugo's Security Policy. By default, environment variables beginning with HUGO_ are allowed when using the os.Getenv function.