Pull an image from Docker Hub (see available-tags):
$ docker pull docker.io/openquake/engine[:TAG]
This modality is recommended when only the WebUI or the API server is used (for example as the backend for the OpenQuake QGIS plugin).
$ docker run --name <containername> -d -p 8800:8800 openquake/engine:latest
Then you can connect to http://localhost:8800 to be able to access the WebUI or the API server.
You can stop and start again your container with the following commands:
$ docker stop <containername>
$ docker start <containername>
This modality provides the same features as the headless mode plus the ability to drive the OpenQuake Engine via the oq
command on a terminal.
$ docker run --name <containername> -t -i -p 8800:8800 openquake/engine:latest
The container prompt will appear, here you play with the oq
shell command.
[openquake@b318358ee053 ~]$ oq --version
3.10.0
After you have restarted you container (same commands as the headless mode) you can re-attach the container shell using:
$ docker attach <containername>
[openquake@b318358ee053 ~]$
To destroy a container, type:
$ docker rm <containername>
To remove its image:
$ docker rmi openquake/<imagename>[:TAG]
You can print the list of containers and images using $ docker ps -a
and $ docker images
. For more details please refer to the official Docker documentation.
If you need help or have questions/comments/feedback for us, you can:
- Subscribe to the OpenQuake users mailing list: https://groups.google.com/g/openquake-users
- Contact us on IRC: irc.freenode.net, channel #openquake