Docker

To use the latest version of GridLAB-D with docker, install docker from see www.docker.com. Then run

host% docker pull gridlabd/slac-master:latest
host% docker tag gridlabd/slac-master:latest gridlabd

To get more information about available docker images, see https://hub.docker.com/u/gridlabd/.

To run your GridLAB-D docker image version of GridLAB-D:

host% docker run -vit $(pwd):/model gridlabd gridlabd -W /model my_model.glm

If you are using a system where command aliases are allowed (e.g., linux):

host% alias gridlabd='docker run -vit $(pwd):/model gld gridlabd -W /model'

You can add this command to your shell profile, e.g., $HOME/.bash_profile. After that you can use the simpler command

host% gridlabd my_model.glm

Docker control

To enable a docker image:

localhost% gridlabd --docker enable <imagename>

Subsequent gridlabd commands will use the docker image gridlabd instead of the local installation.

To disable a docker image:

localhost% gridlabd --docker disable

Subsequent gridlabd commands will use the local installation instead of the docker image gridlabd.

To get a list of available and active docker images:

localhost% gridlabd --docker status
REPOSITORY             TAG                 IMAGE ID            CREATED             SIZE
gridlabd/slac-master   latest              398e452f9a01        2 days ago          1.56GB
gridlabd               latest              398e452f9a01        2 days ago          1.56GB

If the repository gridlabd is listed, then gridlabd will use the docker instance instead of the current installed version.

Docker clean-up

To clean-up resources - images, containers, volumes, and networks - not associated with a container:

~~ %host docker system prune ~~

To remove any stopped containers and all unused images add a flag -a :

~~ %host docker system prune -a ~~