Publishing-the-Wiki

Notes on how this vault is published to wiki.krystex.cc and how to push updates.

Updating the live site

cd /Users/simon/Wiki
git add -A
git commit -m "Describe the change"
git push vps main

That’s it — pushing to the vps remote triggers a post-receive hook on the server that checks out the new content and rebuilds the site automatically (usually done within a few seconds).

How it works

• The vault (this folder) is a git repo; vps is a remote pointing at a bare repo on the VPS (vserver:/home/simon/server/wiki/vault.git).
• A post-receive hook on the VPS checks out the pushed content, then runs a throwaway node:22-alpine Docker container to rebuild the site with Quartz.
• The build output is served by a persistent nginx container, which the VPS’s existing Caddy reverse-proxies to at wiki.krystex.cc.
• Full deployment layout and setup details: ~/quartz-site/deploy/README.md on this machine (not part of this vault, since it’s infrastructure rather than wiki content).

Notes

• Papers/ and this file’s directory structure are excluded from the published site (see ignorePatterns in the Quartz config).
• If git push vps main fails, check the VPS isn’t out of disk space (ssh vserver df -h /) — it was found completely full during initial setup.
• After each rebuild, the wiki nginx container is restarted (part of the post-receive hook) — required because Docker bind mounts go stale when the build deletes/recreates the output directory.

See also

• INDEX