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

|              |                                                                                                           |
| ------------ | --------------------------------------------------------------------------------------------------------- |
| image        | [quartz-docker image](https://code.modernleft.org/gravityfargo/-/packages/container/quartz-docker/v4.4.0) |
| base project | [quartz](https://quartz.jzhao.xyz/)                                                                       |
| image source | [gravityfargo/quartz-dockerl](https://code.modernleft.org/gravityfargo/quartz-docker)                     |

```bash
docker pull code.modernleft.org/gravityfargo/quartz-docker:v4.4.0
```

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

While Quartz provides [Docker support](https://quartz.jzhao.xyz/features/Docker-Support), it is not as self contained as this project.

There is no support for SSL or any other features that are not directly related to building the site. I run everything behind traeffik, so I don't need it.

## 🐳 Docker Compose Setup

Create a data directory

```bash
mkdir -p /srv/quartz
```

```yaml title="docker-compose.yml"
services:
  quartz-docker:
    container_name: quartz-docker
    image: code.modernleft.org/gravityfargo/quartz-docker:dev
    ports:
      - 80:80
    environment:
      USER_ID: 1000
      GROUP_ID: 1001
      SERVER_NAME: "docs.modernleft.org"
      ENABLE_CRON: "true"
      BUILD_SCHEDULE: "*/30 * * * *"
      CONTENT_REPO: "https://code.modernleft.org/gravityfargo/modernleft-docs.git"
    volumes:
      - /srv/quartz:/quartz
```

**First Run**

```bash
docker-compose up -d
docker stop quartz-wiki
```

On first run, the container will download the necessary dependencies, build the site, and download the content repository.

After that, you can configure whatever you would like in `/srv/quartz/src` using the stock options found in the quartz [documentation](https://quartz.jzhao.xyz/configuration) Bare minimum should be `baseUrl` and `pageTitle`.

🥳 Done! 🎉

## Manually Building the Site

If you don't use the cron job, and don't feel like restarting the container, you can build the site manually.

```bash
docker exec -it quartz-wiki bash
cd /quartz/content/ && git restore . && git pull
cd /quartz/src/ && npx quartz build
```

## ⚙️ Configuration

**cron**

This is the an equivalent command to the cron job.


```bash
cd /quartz/content
git restore .
git pull
cd /quartz/src &
npx quartz build
echo 'Content Updated.'
```

Setting `ENABLE_CRON` to `true` and defining `BUILD_SCHEDULE` performs these actions.
If you need help configuring [Crontab.guru - The cron schedule expression generator](https://crontab.guru/) is a useful tool for that

Example:

```yaml
environment:
  ENABLE_CRON: "true"
  BUILD_SCHEDULE: "*/1 * * * *" # Runs every minute
```

### Environment Variables

| Variable             | Description                                  | Default Value                 |
| -------------------- | -------------------------------------------- | ----------------------------- |
| `USER_ID`/`GROUP_ID` | UID/GID that` /quartz` will be chown'd to.   | `1000`:`1000`                 |
| `NGINX_PORT`         | Port for the Nginx server                    | `80`                          |
| `SERVER_NAME`        | NGINX server name                            | `quartz.zhao.xyz`             |
| `ENABLE_CRON`        | Enables scheduled builds (`true` or `false`) | `false`                       |
| `BUILD_SCHEDULE`     | Cron expression for scheduling site builds   | `"*/10 * * * *"` every 10 min |
| `CONTENT_REPO`       | URL of the content repository                |                               |