Spoolhouse

Settings

Workshop-wide rates used in every cost calculation.
Added to cost to absorb failed prints.
Markup over full cost; models can override it.
Glue, IPA, nozzle wear, bags…
Used when no spool of a material exists.
Business & labels
Printed on quotes and shipping labels.
Used in spool QR codes so your phone opens the spool directly.
Networked label printer or a CUPS queue. Must accept PDF.
Publishing — catalog, feeds & OLX
A read-only page with your Active models — also makes their photos publicly reachable, which the feeds and OLX need. Live at http://localhost:8080/shop
A portfolio of projects marked Public — their build logs and photos become visible at /build/{id}. Live at http://localhost:8080/showcase
Used in feeds and OLX prices.
Paste as a scheduled feed URL in Meta Commerce Manager → Catalog → Data sources, and in TikTok Catalog Manager (it accepts Facebook-format feeds). Products marked Active appear automatically.
Register an app at developer.olx.pt (OLX reviews it), paste the credentials, then Connect.
Numeric OLX category for your products.
Numeric OLX city id for the listings.
Email & invoicing
Informal invoices only — not certified faturas (AT) for Portugal.
Backups & export

A snapshot is taken daily and kept (last 14) in the data volume at /data/backups — point Duplicacy there. Export any table as CSV: spools · parts · raw_materials · models · prints · builds · failures · orders · customers · projects

Stripe payments (catalog checkout)

Adds a Buy button to every catalog product — checkout is hosted by Stripe. Create keys in Stripe Dashboard → Developers, and add a webhook for checkout.session.completed pointing at http://localhost:8080/webhooks/stripe. Paid checkouts create a paid order automatically and decrement stock.

Comma-separated ISO codes Stripe may ship to.
Users
UserUsernameSince
Admin you admin 2026-06-28
Security — your account
Use with the spoolctl CLI: spoolctl config --url … --token …. Rotating invalidates the old token.