STL-Quest

STL-Quest

Docker app from richardsolomou's Repository

A private 3D-print request and production queue for resin and filament printers.

Overview
A private 3D-print request and production queue for resin and filament printers. Accept STL requests, order work fairly, assign compatible models across a mixed printer fleet, and track each copy through Queue, Up next, Printing, Finishing, and Ready while files stay on your array. No vendor cloud or printer account is required. Includes built-in accounts and anonymous telemetry with an opt-out. The first person to open the web UI claims the admin account, so open it right after starting the container.
STL Quest logo

STL Quest

A private 3D-print request and production queue for resin and filament printers.

stl.quest

Latest release Build License

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 stages

Who 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 ✨

  1. 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.
  2. You choose the queue order β€” balance work between requesters, print the oldest request first, or pick whatever fits.
  3. STL Quest auto-assigns a compatible printer, or an operator picks one manually.
  4. 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.
  5. 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 /data should stay on a local filesystem. Set DATABASE_URL to use PostgreSQL instead.

Other installs

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

GNU Affero General Public License v3.0

Categories

Related apps

Links

Details

Repository
ghcr.io/richardsolomou/stl.quest:latest
Last Updated2026-11-22
First Seen2026-07-22

Runtime arguments

Web UI
http://[IP]:[PORT:3000]/
Network
bridge
Shell
sh
Privileged
false
Extra Params
--user 99:100

Template configuration

WebUI PortPorttcp

Port for the STL Quest web interface.

Target
3000
Default
30455
Value
30455
App dataPathrw

STL Quest's database and settings. Keep on appdata.

Target
/data
Default
/mnt/user/appdata/stlquest
Value
/mnt/user/appdata/stlquest
Print filesPathrw

Share where your private resin and filament STL files live. STL Quest keeps them as plain files organized by production stage.

Target
/prints
Base pathVariable

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 URLVariable

Public URL used in password-reset and email-verification links. Set this and configure SMTP to enable these links.

Target
BETTER_AUTH_URL
Database URLVariable

Optional PostgreSQL URL. Leave empty to use local SQLite.

Target
DATABASE_URL
Allow OIDC account creationVariable

Leave empty to use the Super Admin account creation setting. Set true or false to override it.

Target
AUTH_OIDC_ALLOW_SIGNUP