modernleft-docs/Applications/quartz-docker.md

title	draft	date
quartz-docker	false	2025-01-16

📄 quartz-docker

quartz-docker image

This project runs Quartz 4, a fast, batteries-included static site generator, inside a Docker container. It transforms Markdown content into a fully functional website.

🚀 Features

• configurable with environment variables
• node and nginx included
• configurable cron for job to pull and build site

🛠️ Getting Started

Docker Compose

See a list of all Environment Variables environment variables

1. Create a data directory and pull your existing content

   git clone https://code.modernleft.org/gravityfargo/modernleft-docs.git quartz
   

2. Create a docker-compose.yml file

Minimal

!minimal docker-compose

BASE_URL

The only required variable is BASE_URL. The rest are set to the developer's defaults BASE_URL sets both quartz's baseUrl as well as nginx's server_name.

Recommended

!recommended docker-compose node_modules volume: To keep the image small, node_modules are not included. When the container is run, they're downloaded to /usr/share/nginx/html/node_modules. You should keep them in a volume so that the modules persist between container runs.

cron You should also set ENABLE_CRON to true and set BUILD_SCHEDULE to a cron expression to enable the cron job that npx quartz build is executed which will pull the latest content and build the site.