Home

STL Studio — Documentation

A locally-hosted web app for cataloguing, browsing, and managing a large STL model library — search, filter, tag, preview in 3D, and plan your prints.

Contents

Guide	What's inside
Getting Started	Download, run, point it at your drives, and run your first scan
Docker — Drive Mounts	Configuring drive mounts in Docker mode — adding/changing drives, container vs. host paths, read-only mounts
Feature Guide	Every screen and what it does — Library, Triage, favorites, print queue, collections, image picker, Kit Builder, enrichment, bulk enrich, import folder, reorganize, Paint Shelf & PaintRack CSV, AI & Integrations, backup & restore
Scanning & Folder Structure	How the scanner finds your models, the folder layout it expects, and automatic tagging
Troubleshooting & FAQ	Models not showing up, wrong thumbnails, rescan vs. full scan, and other common questions
Support and Compatibility Policy	Supported platforms, upgrades, backups, rollback limits, support channels, and diagnostic privacy
Clean-machine Release Acceptance	Operator-ready Windows release checks for installation, scanning, persistence, backup/restore, update, diagnostics, and uninstall
Adverse Failure Qualification	Repeatable release checks for interrupted updates, storage failures, locked databases, missing drives, and invalid settings
Dependency and License Audit	v1.0 dependency inventories, vulnerability results, license policy, unused-package decisions, and recurring audit gates
Release Supply-Chain Verification	Verify release checksums, CycloneDX SBOMs, and GitHub artifact attestations

What it does, in one paragraph

Point STL Studio at the folder(s) where your STL files live (your external drives, a NAS, wherever). It walks the folders, detects each model, pulls in preview images and any metadata it can find, and builds a searchable library. From there you can filter by creator, scale, type, or tag; mark favorites; queue models to print; track what you've already printed; preview STLs in 3D; assemble multi-part builds; and group models into named collections.

The catalog and model files stay on your machine. Optional AI and storefront integrations make network requests only when you configure and use them; see AI & Integrations.