STL-Quest
Docker app from richardsolomou's Repository
A private 3D-print request and production queue for resin and filament printers.
Overview
Readme
View on GitHubSTL Quest
A private 3D-print request and production queue for resin and filament printers.
Collect STL requests in one place, decide what to print next, match jobs to compatible printers, and track every copy from Queue β Up next β Printing β Finishing β Ready.
STL Quest request board showing print jobs moving through production stagesWho is it for? π
STL Quest replaces scattered spreadsheets and chat threads with one shared queue. It is designed for:
- Hobbyists printing for friends who want a simple way to track requests, quantities, and progress.
- Print farms and small businesses juggling more printers, more customers, and a growing backlog.
How it works β¨
- Requesters upload models or save source links with quantity, notes, and a preferred print type. Links to MakerWorld and Printables get their cover automatically, and any linked print can take a pasted or uploaded cover image.
- You choose the queue order β balance work between requesters, print the oldest request first, or pick whatever fits.
- STL Quest auto-assigns a compatible printer, or an operator picks one manually.
- Your slicer handles the build β orientation, arrangement, and supports. A print opens straight in OrcaSlicer, or downloads for any other slicer, named with its request tag such as
SQ-142 Plasma.3mf. - Each copy is tracked through printing, finishing, and collection.
Along the way:
- Private workspaces with invites, social login, OpenID Connect single sign-on, and two-factor authentication.
- Interactive STL, 3MF, and OBJ previews, thumbnails, filtering, and drag-and-drop board controls. OBJ geometry is supported without companion MTL or texture files.
- Mixed resin and filament fleets with dimension-aware auto-assignment.
- Local, S3-compatible, Dropbox, Google Drive, OneDrive, or Box storage, with guided migration.
- Filament stock read from Spoolman through a small bridge that only connects out, on hosted and self-hosted installs alike.
- Fair ordering, manual requester priorities, and withdrawal controls.
- Automatic migrations, backups, health checks, and optional print-ready email notifications that carry your workspace logo and can go out through your own mail server.
- Built-in realtime updates and board presence with no additional service to install.
Self-hosted or managed π
Run STL Quest for one group on your own server, or host separate workspaces for several groups. Each workspace has its own board, printers, members, and storage. Users can join more than one workspace by invitation or be added directly by a super admin.
Super admins can add an existing account from Super Admin β Workspaces β open a workspace β Add user, or from Settings β Members β Add user (/settings/users) for the current workspace. Search by name or email and choose Member or Admin; access starts immediately without an invitation link. To create an account first, use Super Admin β Users β Add user.
To remove a member, open the workspace under Super Admin β Workspaces and select Remove member, then confirm. Their account and existing print requests are kept, and their request-visibility override is cleared. Workspace owners and your own membership cannot be removed through this action.
With self-hosting, you control the app, database, files, and history. Hosted accounts include storage hosted by STL Quest and shared across three owned workspaces, with optional paid plans for larger libraries, while other workspaces connect their own remote storage. See the storage guide for the full policy.
STL Quest does not slice models or control printers, and it does not include a public gallery or marketplace.
Anonymous telemetry is on by default, never includes model files or request content such as names and notes, and can be disabled anytime β see the telemetry page for exactly what's sent.
Run it π
docker run -d --name stlquest \
--user "$(id -u):$(id -g)" \
--read-only --tmpfs /tmp:size=256m,mode=1777 \
-p 30455:3000 \
-v /path/to/appdata:/data \
-v /path/to/prints:/prints \
ghcr.io/richardsolomou/stl.quest:latest
Open http://localhost:30455. The first account created becomes the super admin. Anyone who can reach the server can then create an account. To disable public account creation, turn off Allow self-signup under Super Admin β Users.
Local SQLite is the default and
/datashould stay on a local filesystem. SetDATABASE_URLto use PostgreSQL instead.
Other installs
- Docker Compose: configure
docker-compose.ymland.env.example, then rundocker compose up -d. - TrueNAS SCALE / HexOS: Install STL Quest from the TrueNAS Apps catalog
- Unraid: Install STL Quest from Unraid Community Apps
See the deployment guide for platform-specific installation notes and manual alternatives.
Configuration βοΈ
Use Workspace Settings to manage printers, members, board behavior, and storage. Use Super Admin to manage user accounts, sign-in methods, email delivery, telemetry, and diagnostics.
OIDC sign-in creates new accounts by default when self-signup is open. Change Allow account creation on sign-in in the OIDC setup dialog, or set AUTH_OIDC_ALLOW_SIGNUP=false to restrict OIDC to existing accounts. Invited people and the first account on a new install can still sign up through OIDC.
Set BETTER_AUTH_URL to the public URL and configure SMTP to enable password-reset and email-verification links. See the deployment guide for environment variables, reverse proxy setup, health checks, backups, and upgrades.
Storage and backups πΎ
Store models in a local folder, a WebDAV folder, S3-compatible storage, or a connected cloud account. Settings β Storage can migrate existing files when you switch providers. See the storage guide for supported services and setup instructions.
Back up /data and your model store together before upgrading β see the deployment guide for backups, encryption keys, and restores.
Your slicer remains the source of truth for orientation, arrangement, supports, infill, and material use.
Development π οΈ
Requires Node 24.x and the pnpm version in package.json's packageManager field. Setup, checks, and release guidance live in CONTRIBUTING.md; see SECURITY.md for vulnerability reports and GitHub Issues for planned work.
The UI components and their used Tailwind state variants live in src/components/ui/ and src/ui-variants.css. The application does not need the shadcn generator CLI at install or build time.
License
Categories
Related apps
Explore more like this
Explore allLinks
Details
ghcr.io/richardsolomou/stl.quest:latestRuntime arguments
- Web UI
http://[IP]:[PORT:3000]/- Network
bridge- Shell
sh- Privileged
- false
- Extra Params
--user 99:100
Template configuration
Port for the STL Quest web interface.
- Target
- 3000
- Default
- 30455
- Value
- 30455
STL Quest's database and settings. Keep on appdata.
- Target
- /data
- Default
- /mnt/user/appdata/stlquest
- Value
- /mnt/user/appdata/stlquest
Share where your private resin and filament STL files live. STL Quest keeps them as plain files organized by production stage.
- Target
- /prints
Optional path prefix, such as /stlquest, when a reverse proxy serves STL Quest under a subpath of another site. Leave empty to serve it at the root.
- Target
- BASE_PATH
Public URL used in password-reset and email-verification links. Set this and configure SMTP to enable these links.
- Target
- BETTER_AUTH_URL
Optional PostgreSQL URL. Leave empty to use local SQLite.
- Target
- DATABASE_URL
Leave empty to use the Super Admin account creation setting. Set true or false to override it.
- Target
- AUTH_OIDC_ALLOW_SIGNUP