Environment Variables

Environment variables are a common way to configure applications at runtime. Unikraft Cloud supports passing environment variables to instances during deployment through many methods. This tutorial discusses each below and orders them by superseeding precedence (from most powerful to weakest).

Below are all the ways you can set environment variables for your Unikraft Cloud instances. The order they're presented is from the least precedence to the highest precedence.

Dockerfile ENV

You can set environment variables in your Dockerfile using the ENV instruction in your target FROM stage. The CLI automatically reads them when building the image and sets them in the resulting packaged image.

Dockerfile
# ...
FROM ubuntu:latest
ENV MY_ENV_VAR=my_value
# ...

Kraftfile env

You can set environment variables in your Kraftfile using the env field. kraft automatically reads them when building the image and sets them in the resulting packaged image.

Kraftfile
# ...
env:
  MY_ENV_VAR: my_value

CLI flags

When deploying an instance, you can pass environment variables using the --env (or -e) flag. You can specify many environment variables by using the flag many times. The flag works similarly to the docker run -e flag.

Wrapper script

Create a wrapper script that sets the environment variables before executing the main app. Check what the original entrypoint of your app is and call it after setting the variables. For example, if the original entrypoint is /entrypoint.sh, you can create a new script wrapper.sh like this:

wrapper.sh
#!/bin/sh

export MY_ENV_VAR="my_value"

exec /entrypoint.sh "$@"

Then you change either your Dockerfile or Kraftfile to use this wrapper script as the entrypoint:

Dockerfile
# ...
COPY wrapper.sh /wrapper.sh
RUN chmod +x /wrapper.sh
ENTRYPOINT ["/wrapper.sh"]

Learn more

• The CLI reference and the legacy CLI reference.
• The Dockerfile reference for understanding how to set environment variables in Dockerfiles.
• The Kraftfile reference for understanding how to set environment variables in Kraftfiles.