...

README.md

@@ -115,6 +115,30 @@ simstadt PV path/to/city.gml --verbose
 regionchooser
 ```
 
+## Docker
+
+A ready-to-use image is published at [`simstadt/simstadt:cli`](https://hub.docker.com/r/simstadt/simstadt). It bundles Java, INSEL, and this package (installed from PyPI) with a real SimStadt install.
+
+```bash
+# Health check: shows the detected SimStadt version
+docker run --rm simstadt/simstadt:cli
+
+# Run a workflow against a mounted CityGML file
+mkdir -p data
+cp path/to/city.gml data/building.gml
+docker run --rm -v "$(pwd)/data:/data" simstadt/simstadt:cli \
+  simstadt HeatDemand /data/building.gml -p /data/output -f
+```
+
+Results are written to `data/output.proj/` on the host.
+
+Bring your own templates by mounting them and overriding `SIMSTADT_TEMPLATE_PATH`:
+
+```bash
+docker run --rm -v "$(pwd)/data:/data" -e SIMSTADT_TEMPLATE_PATH=/data/templates \
+  simstadt/simstadt:cli simstadt MyTemplate /data/building.gml -p /data/output
+```
+
 ## Development
 
 ```bash