name	preview
description	Start local MkDocs preview server to view training material changes. Use when editing documentation, checking formatting, or testing how content renders before committing.

Start the local MkDocs preview server to view changes to training materials.

First, check if a server is already running:

docker ps --filter "ancestor=ghcr.io/nextflow-io/training-mkdocs:latest" --format "{{.ID}}"

If a container ID is returned, the server is already running at http://127.0.0.1:8000/
If no output, proceed to start a new server

Start the server using Docker (recommended):

docker run --rm -d -p 8000:8000 -v ${PWD}:/docs -w /docs/docs/en ghcr.io/nextflow-io/training-mkdocs:latest

Alternative - using uv:

uv run _scripts/docs.py serve

After starting the server:

Common issues:

name	preview
description	Start local MkDocs preview server to view training material changes. Use when editing documentation, checking formatting, or testing how content renders before committing.