37 lines
1.1 KiB
Markdown
37 lines
1.1 KiB
Markdown
---
|
|
title: quartz-docker
|
|
draft: false
|
|
date: 2025-01-16
|
|
---
|
|
|
|
# 📄 quartz-docker
|
|
|
|
[quartz-docker image](https://code.modernleft.org/gravityfargo/-/packages/container/quartz-docker/v4.4.0)
|
|
|
|
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|here.]]
|
|
|
|
1. Create a data directory and pull your existing content
|
|
|
|
```bash
|
|
git clone https://code.modernleft.org/gravityfargo/modernleft-docs.git quartz
|
|
```
|
|
|
|
2. Create a `docker-compose.yml` file
|
|
![[minimal docker-compose]]
|
|
The only required variable is `BASE_URL`. The rest are set to the developer's [defaults](https://quartz.jzhao.xyz/configuration) `BASE_URL` sets both quartz's "baseUrl" as well as nginx's `server_name`.
|
|
|
|
### Cron
|
|
|
|
![[cron]]
|