Skip to content

Running locally

Requires Docker. The following commands should be entered and run in a terminal program like bash.

Clone the repository

git clone https://github.com/cal-itp/mkdocs-template
cd mkdocs-template

Build the image

docker build -t mkdocs-template -f docs/Dockerfile .

Run a container

docker run -p 8000:8000 mkdocs-template

The site should be available at http://localhost:8000.

VS Code Remote Containers

This repository comes with a VS Code Remote Containers configuration file.

Once you clone the repository locally, simply open it within VS Code, which will prompt you to re-open the repository within the Remote Container.

Once running inside the Remote Container, the site is available at http://localhost:8000.