REGISTER NOW: Brightway Spring School! 🇨🇦 Québec City (Canada) 🗓️ 20.-24. May 2024

Docker Setup#


  1. Basic knowledge of Docker.

  2. Basic knowledge of the difference between brightway2 and brightway 25

Brightway publishes two official docker images:

Based on the Jupyter minimal notebook.

What it Gives You#

  • Miniconda

  • Python 3.10

  • Jupyterlab

  • brightway2 framework

Docker instances are ephemeral. You will almost certainly want to mount a data volume.

Usage of bw2 image#

To run an instance of Jupyter Lab, accessible at localhost:8888:

docker run --rm -p 8888:8888 -e JUPYTER_ENABLE_LAB=yes brightway/bw2

Jupyterlab also allows you to run iPython sessions or even a terminal.

See the Jupyter documentation for more usage options.



The brightway2 docker images are currently built and tagged based on the following different components of the image

  • brightway2 metapackage version (2.4.3)

  • python version (py310, py311, py312)

  • the python distribution (official python 3 or miniconda3)

  • Ecoinvent 3.X compatibility (3.8, 3.9) version [1]

The following images are built:

Image Name



brightway 2.4.3, py310, miniconda3, compatible with ecoinvent 3.9