Self-host Spoolman on a VPS
A filament spool inventory manager for 3D printers with usage tracking and printer firmware integrations. MIT licensed. On first open, add your filaments and vendors; there is no login, so keep it behind a private network or an auth proxy.
levelrail-cli templates install spoolman --name my-spoolmanSpecification
- Status
- Listed
- Category
- Applications
- Services
- spoolman
- Ports
- 8000
- Volumes
- 1
- Memory
- about 256 MiB
- arm64
- image published
- amd64
- image published
- Settings to fill in
- none
- License
- Permissive license, MIT
About Spoolman
A filament spool inventory manager for 3D printers with usage tracking and printer firmware integrations. MIT licensed. On first open, add your filaments and vendors; there is no login, so keep it behind a private network or an auth proxy.
What it deploys
Spoolman runs as one service in a single Compose app, listening on port 8000, with 1 named volume mount.
| Service | Image | Tag | Ports | Volumes |
|---|---|---|---|---|
| spoolman | ghcr.io/donkie/spoolman | 0.27.1 | 8000 | data -> /home/app/.local/share/spoolman |
Before you install
- CPU architecture. arm64 listed. Every image lists linux/arm64 in its registry manifest. That is a manifest fact, not proof the app runs on Arm.
- Listed. It is in the catalog. Back up the data volume before changing an image tag.
Settings and environment
You do not have to fill in anything. Values are never shown here.
| Service | Variable | Value |
|---|---|---|
| spoolman | SPOOLMAN_DB_TYPE | Preset by the template |
| spoolman | TZ | Preset by the template |
Install Spoolman on a VPS
-
Install Levelrail on a fresh VPS
Run this as root on a Linux server (amd64 or arm64) with ports 80 and 443 reachable. The installer prints a setup link.
curl -fsSL https://levelrail.com/install.sh | sudo sh -
Sign in
Open the setup link, choose a password, then log the CLI in. The CLI install command is
curl -fsSL https://levelrail.com/install-cli.sh | shif the machine does not have it. See Getting started.levelrail-cli login --device -
Read the template
Shows the entry, including its full compose.yaml.
levelrail-cli templates get spoolman -
Install it
This template has an install form, so the CLI fills each setting from --env, a generated secret or its default.
levelrail-cli templates install spoolman --name my-spoolmanTo put a service behind a domain at install, add
--domain SERVICE=HOST:levelrail-cli templates install spoolman --name my-spoolman --domain spoolman=spoolman.example.com
Without a domain the app gets an sslip.io address. You can also deploy it from the dashboard: Apps, New app, Browse templates, then Spoolman.
Docs and upstream
More in Applications
- TasmoAdminA web panel to manage and update many Tasmota smart home devices from one place.
- SeerrA media request manager for Jellyfin, Plex and Emby with Sonarr and Radarr hand-off, the merged successor of Overseerr and Jellyseerr. MIT licensed. On first open, sign in with your media server account to become the admin.
- SearXNGA privacy-respecting metasearch engine that aggregates results from dozens of search services.
- SABnzbdA Usenet binary downloader with a web interface, RSS and post-processing. GPL-2.0 licensed. On first open, run the setup wizard to add your Usenet provider; if you serve it on a domain, add that host name under Config, Special, host_whitelist.
- ThingsBoardAn IoT platform to collect, store and visualise device data, in one container with its own PostgreSQL.
- RSS-BridgeGenerates RSS and Atom feeds for websites that do not offer them, using a library of small bridges. Unlicense (public domain). Runs in one container with no database. Public to anyone with the link, so restrict it if you only want private use.