---
title: "Deploy Spoolman"
description: "Self-hosted 3D-printer filament spool inventory, password-protected"
category: "Other"
url: https://railway.com/deploy/spoolman-1
---

# Deploy Spoolman

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

**[Deploy Spoolman on Railway](https://railway.com/template/spoolman-1)**

Machine-readable deploy manifest (JSON, validated by TemplateCI): https://railway.com/deploy/spoolman-1/manifest.json

- **Creator:** Agaz Self-Host
- **Category:** Other

## Template content

### Spoolman https://cdn.jsdelivr.net/gh/homarr-labs/dashboard-icons/png/spoolman.png

- **Source:** https://github.com/aalfath/spoolman-railway-template
- **Health check:** /health
- **Public domain:** Yes

### Postgres https://devicons.railway.app/i/postgresql.svg

- **Image:** ghcr.io/railwayapp-templates/postgres-ssl:18

## Documentation

# 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

* Spoolman source and documentation: https://github.com/Donkie/Spoolman
* Spoolman 0.27.1 release: https://github.com/Donkie/Spoolman/releases/tag/v0.27.1
* Spoolman security notes: https://github.com/Donkie/Spoolman/wiki/Security
* Template repository: https://github.com/aalfath/spoolman-railway-template

### 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`:

```ini
[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.



## Similar templates

- [Rocky Linux](https://railway.com/deploy/rocky-linux) — Hosted Rocky Linux 9 workspace with SSH and persistent storage. 🚀
- [Foundry Virtual Tabletop](https://railway.com/deploy/X5tR6G) — Self-hosted virtual tabletop for role-playing games (license required)
- [Double Commander in your browser](https://railway.com/deploy/double-commander-in-your-browser) — The Double Commander file manager in the cloud, from any device

Open this page in a browser: https://railway.com/deploy/spoolman-1
