Deploy Spoolman

Self-hosted 3D-printer filament spool inventory, password-protected

Deploy Spoolman

/home/app/.local/share/spoolman

/var/lib/postgresql/data

Deploy and Host Spoolman on Railway

Spoolman is an open-source, self-hosted inventory for 3D-printer filament. It tracks manufacturers, filaments and individual spools, including how much filament each spool has left. Klipper (through Moonraker), OctoPrint, Home Assistant and other tools report usage to it, so remaining weights update as you print. It has a web UI and a REST API.

About Hosting Spoolman

This template runs Spoolman 0.27.1 from the official ghcr.io/donkie/spoolman image, pinned by version and digest. It builds from the repository aalfath/spoolman-railway-template. Spoolman has no login of its own, and its developers advise putting it behind an authenticating proxy when it can be reached from the internet. So the app service puts a Caddy basic-auth front door on the public port and binds Spoolman to localhost. A Railway PostgreSQL service holds all the data. The deploy form asks for nothing: Railway generates the password and the database credentials. Migrations run on every start. Both services fit Railway's 0.5 GB per-service memory limit.

Common Use Cases

  • Check how much filament is left on each spool before starting a long print
  • Have Klipper/Moonraker or OctoPrint deduct the filament every print uses, across several printers
  • Keep one shared filament inventory with prices, locations and lot numbers for a workshop or makerspace

Dependencies for Spoolman Hosting

  • Spoolman web app and API, with a Caddy basic-auth front door (service "Spoolman", built from this template's repo)
  • PostgreSQL database (service "Postgres", Railway's own image, with its own volume)

Deployment Dependencies

Implementation Details

After deploy, open the service's Railway domain and sign in with SPOOLMAN_AUTH_USERNAME (default admin) and SPOOLMAN_AUTH_PASSWORD from the Spoolman service's Variables tab. /health answers without login for Railway's health check. A printer client that can't show a login prompt can put the credentials in the URL, for example in Moonraker's moonraker.conf:

[spoolman]
server: https://admin:YOUR-PASSWORD@YOUR-DOMAIN.up.railway.app

Other upstream settings (TZ, SPOOLMAN_CORS_ORIGIN for a Fluidd or Mainsail UI on another address, SPOOLMAN_METRICS_ENABLED) can be added as service variables. Updates: when the repository moves to a newer Spoolman, Railway shows an "update available" notice; read the repository's CHANGELOG.md before you apply it.

Why Deploy Spoolman on Railway?

Railway is a singular platform to deploy your infrastructure stack. Railway will host your infrastructure so you don't have to deal with configuration, while allowing you to vertically and horizontally scale it.

By deploying Spoolman on Railway, you are one step closer to supporting a complete full-stack application with minimal burden. Host your servers, databases, AI agents, and more on Railway.


Template Content

More templates in this category

View Template
Rocky Linux
Hosted Rocky Linux 9 workspace with SSH and persistent storage. 🚀

codestorm
51
View Template
Foundry Virtual Tabletop
Self-hosted virtual tabletop for role-playing games (license required)

Lucas
71
View Template
NEW
Double Commander in your browser
The Double Commander file manager in the cloud, from any device

Nermin Sabanovic
0