Blot

Blot is a site generator. Blot turns a folder into a website. The point of all this — the reason Blot exists — is so you can use your favorite tools to create whatever you publish. This is the source code for the hosted service:

https://blot.im

You can contact us:

[email protected]

The general architecture of Blot is:

The internet <> Reverse proxy (Openresty) <> Blot (express.js node application) <> Redis

Blog pages, on subdomains and custom domains, are served by the reverse proxy directly, with no CDN in front. The CDN (Bunny) serves only cdn.blot.im URLs: static assets, blog CSS and JS, and folder files and generated assets that blog links point there.

Self-hosting Blot is currently unsupported. Please don’t file issues or contact support about it. I hope to support this properly someday, but not yet.

To run Blot locally, you will need Node.js 24.22.1 (LTS), Docker, mkcert and dnsmasq. Then:

git clone https://github.com/blotcms/blot --depth 1 cd blot nvm install nvm use npm start

The nvm commands use the version pinned in .nvmrc. If you use another Node version manager, select Node.js 24.22.1 before running npm start.

The dashboard is https://local.blot and the example site is https://example.local.blot. For the full setup, see:

https://blot.im/developers/guides/run-blot-locally