How Do I Pass Environment Variables to Docker Containers?

Better Stack Team
Updated on October 5, 2023

It is always a good practice to separate the app from its configuration. It is not a good idea to have a database login credential defined as variables in the code of the application. This is why we use environment variables. But this means we need a way to pass the value somehow to the application running in the Docker container.

There are two main ways to inject environment variables into Docker containers.

Using the command line argument -env or -e

When you launch docker using the docker run command, you can pass the environment variables as a key-value pair using the -env (or -e) option.

 
docker run --name ubuntu -env VARIABLE='value' -d ubuntu

If you have a variable already exported like this:

 
export VARIABLE='value'

You can pass the variable into the docker like this:

 
docker run --name ubuntu -env VARIABLE -d ubuntu

Using the .env file

Passing the variable using the command option argument is easy for a small number of variables. If you need to pass many variables at the same time, it is always better to use .env file.

The .env file (also called envfile) is a simple text file in which the variables are defined as key-value pairs.

You can append variables to envfile using the following syntax:

 
echo VARIABLE1='value1' > envfile.txt
echo VARIABLE2='value2' >> envfile.txt
echo VARIABLE3='value3' >> envfile.txt

Please, notice the >> operator when appending to an existing file. Using the > operator would overwrite the content.

If you are new to Docker, feel free to start with our Getting started logging guide.

Make your mark

Join the writer's program

Are you a developer and love writing and sharing your knowledge with the world? Join our guest writing program and get paid for writing amazing technical guides. We'll get them to the right readers that will appreciate them.

Write for us
Writer of the month
Marin Bezhanov
Marin is a software engineer and architect with a broad range of experience working...
Build on top of Better Stack

Write a script, app or project on top of Better Stack and share it with the world. Make a public repository and share it with us at our email.

community@betterstack.com

or submit a pull request and help us build better products for everyone.

See the full list of amazing projects on github