Quartz 4

📝 Obsidian + Quartz Setup

2 min read

Obsidian + Quartz Setup

Knowledge base system using Obsidian for editing and Quartz for local publishing.

Architecture

Obsidian (local edit) → Git push (backup) → PM2 Quartz serve → NPM → notes.shdwnet.cloud

Local Setup

ComponentLocation
Vault~/Documents/notes.shdwnet.org/content/
Quartz~/Documents/notes.shdwnet.org/
AppFlatpak: md.obsidian.Obsidian

Launch Obsidian

flatpak run md.obsidian.Obsidian

PM2 Service

Quartz runs locally via PM2, serving on port 3030.

PropertyValue
Namequartz-notes
Port3030
Host0.0.0.0 (all interfaces)
URLhttps://notes.shdwnet.cloud

Manage Service

pm2 list                    # Check status
pm2 logs quartz-notes       # View logs
pm2 restart quartz-notes    # Restart after changes

Start Command (if needed)

cd ~/Documents/notes.shdwnet.org
pm2 start "npx quartz build --serve --port 3030" --name quartz-notes
pm2 save

⚠️ Do NOT use pm2 serve — it doesn’t handle directory index.html properly. Use Quartz’s built-in server.

GitHub (Backup Only)

PropertyValue
Repored40mademedoit/notes.shdwnet.org
Branchmain
SSH Key~/.ssh/github_ed25519

⚠️ GitHub is for version control/backup only. No Cloudflare Pages deployment.

NPM Reverse Proxy

PropertyValue
Domainnotes.shdwnet.cloud
Forward192.168.1.156:3030
SSLLet’s Encrypt

Workflow

Daily editing:

  1. Open Obsidian
  2. Edit notes in content/
  3. Changes appear live at https://notes.shdwnet.cloud (PM2 watches files)
  4. Commit and push for backup:
cd ~/Documents/notes.shdwnet.org
git add .
git commit -m "Update notes"
git push

Vault Structure (PARA)

  • 00-Inbox/ — Quick capture
  • 01-Projects/ — Active, time-bound
  • 02-Areas/ — Ongoing interests
  • 03-Resources/ — Reference material
  • 04-Archive/ — Completed/dormant
  • 05-Documentation/ — Technical docs
  • Daily/ — Daily notes
  • Maps/ — Maps of Content
  • Templates/ — Note templates

Firewall Notes

NordVPN allowlist must include port 3030 for NPM to reach Quartz:

nordvpn allowlist add port 3030
  • Dataview
  • Calendar
  • Templater
  • Git

Graph View

Backlinks