docker-documentation/local.md

Local development

Thanks to the group plugin, we do not run slow plugins on local runs, to replicate a real build, add the CI variable, -e CI=true.

Build image

docker build -t lsio/documentation -f Dockerfile .

Run image

With docs from buildtime

docker run --rm --name=docs -p 8000:8000 lsio/documentation

With docs from runtime

docker run --rm --name=docs -p 8000:8000 -v $PWD:/app/mkdocs lsio/documentation

With watching at runtime

docker run --rm --name=docs -p 8000:8000 -v $PWD:/app/mkdocs lsio/documentation -a 0.0.0.0:8000 --dirty

With custom port

docker run --rm --name=docs -p 9999:9999 lsio/documentation -a 0.0.0.0:9999