Skip to content

Building the WindNinja Docker Image

latwood edited this page Jun 3, 2026 · 7 revisions

Creating a WindNinja Docker Image

Get WindNinja Source

Clone the WindNinja source code to your local machine.

git clone https://github.com/firelab/windninja.git 

Install Docker

Install Docker on your system.

sudo apt install docker.io

Build the WindNinja Docker Image

Note: The most up to date dockerfile is found in the master branch here. Additionally, If you do not need OpenFOAM, remove lines 82-97.

Navigate to the source directory and build the docker image. This will build the Docker image with the tag windninja:latest. See Dockerfile for more.

cd ~/src/wind/windninja 
docker build -t windninja:latest .   

After the build is complete, confirm the image is available. It will be listed as windninja.

sudo docker images

Run the WindNinja Docker Image

Note: While the CLI works, the GUI will require additional configuration as it needs access to a display.

Run the docker image with bash enabled.

sudo docker run -it windninja /bin/bash

Ensure the CLI was built properly. For more information on using the CLI, see here.

WindNinja_cli

Clone this wiki locally