selfhost.directory

The index of self-hostable projects — ranked, categorized and served with live updates.
Own your data and stop giving it to big tech.

GitHub
MakersVault logo

Self-host MakersVault

v5

Self-hosted 3D print file manager with in-browser previews

BetaOpen SourceMIT
Updated7 months ago
LanguagePython
Setup difficultyModerate
ThemeDark mode
Stars
252
Ports
8000 (API (FastAPI)), 5173 (Web UI (Nginx/Vite))
Docker
shotgunwilly555/makersvault-web
Install with Docker Compose
Makers Vault home screen showing file libraryLogin screenLanding page with all items viewFile upload interfaceDrag and drop uploadImport from link interfaceInteractive 3D model previewFolder creation interfaceBatch tagging interfaceSettings page with Open in Slicer configuration

What is MakersVault?

Makers Vault is a self-hosted web application for managing 3D printing files and creative illustrations. It provides a browser-based interface to organize files into folders, tag them, add notes, and preview 3D models interactively using three.js. Users can import models directly from MakerWorld, Printables, and Thingiverse via URL, and open files in their local slicer through a companion bridge application. The stack uses React/TypeScript for the frontend, FastAPI with SQLite for the backend, and deploys via Docker Compose. It supports light/dark themes, batch operations, and configurable storage paths. The project is in beta (v5.1.2) with authentication defaults suitable only for trusted local networks.

Should you self-host MakersVault?

MakersVault scores 45/100 on selfhost.directory (how scoring works) and ranks #26 of 34 in File Management. It has 252 GitHub stars.

It shipped 1 stable release in the past year. The latest, v5, came out on 1 January 2026.

Setup is moderate: expect some configuration beyond a single command. An official Docker image is available. It is MIT-licensed and written mostly in Python.

Its closest alternative on selfhost.directory is AList (83/100, 50 365 stars). It scores higher overall, so compare the two before you pick. See MakersVault vs AList side by side.

Features

  • 3D Model Preview
  • Batch Operations
  • Configurable Storage Paths
  • Drag and Drop Upload
  • File Notes
  • Folder Organization
  • Import from URLBeta feature
  • Mounted Folder Import
  • Open in SlicerBeta; requires separate Slicer Bridge installation on client machine
  • Prepared Print Metadata
  • Supporting Files
  • Tagging
  • ZIP Import Handling

MakersVault README

How to install MakersVault

Install MakersVault with Docker Compose

Docker and Docker Compose
Environment variables
PUID, PGID, API_IMAGE, WEB_IMAGE, FILE_STORAGE, DB_URL, API_PORT, WEB_PORT, PUBLIC_URL, CORS_ORIGINS, VITE_API_URL, VITE_ALLOWED_HOSTS, AUTH_USERNAME, AUTH_PASSWORD, AUTH_SECRET, AUTH_TOKEN_TTL, IMPORT_MOUNT_PATH, IMPORT_MOUNT_PATH_HOST, IMPORT_MOUNT_EXTS, IMPORT_MOUNT_INCLUDE_HIDDEN, IMPORT_MOUNT_ON_STARTUP, IMPORT_MOUNT_COPY

cd makervault docker compose -f docker-compose.deploy.yml up -d

Production deployment uses docker-compose.deploy.yml; local development uses docker-compose.yml

How to configure MakersVault

  • API_IMAGEshotgunwilly555/makersvault-api:latestDocker image for the API service

    Docker image for the API service

  • API_PORT8000Port the API listens on

    Port the API listens on

  • AUTH_PASSWORDsuper-secretDefault admin password

    Default admin password

  • AUTH_SECRETreplace-with-random-secretSecret key for JWT tokens

    Secret key for JWT tokens

  • AUTH_TOKEN_TTL43200Token time-to-live in seconds

    Token time-to-live in seconds

  • AUTH_USERNAMEadminDefault admin username

    Default admin username

  • CORS_ORIGINSAllowed CORS origins for API access

    Allowed CORS origins for API access

  • DB_URLsqlite:///./app.dbDatabase connection URL (SQLite)

    Database connection URL (SQLite)

  • FILE_STORAGE/app/storagePath for file storage inside the container

    Path for file storage inside the container

  • IMPORT_MOUNT_COPYtrueCopy files instead of linking

    Copy files instead of linking

    values: true,false

  • IMPORT_MOUNT_EXTSstl,3mf,step,stp,obj,svg,png,jpg,jpeg,webp,bmp,lbrn,lbrn2,zipFile extensions to import from mounted path

    File extensions to import from mounted path

  • IMPORT_MOUNT_INCLUDE_HIDDENfalseInclude hidden files in import

    Include hidden files in import

    values: true,false

  • IMPORT_MOUNT_ON_STARTUPtrueRun import on container startup

    Run import on container startup

    values: true,false

  • IMPORT_MOUNT_PATH/importsContainer path for mounted imports

    Container path for mounted imports

  • IMPORT_MOUNT_PATH_HOST/path/to/importsHost path for mounted imports

    Host path for mounted imports

  • PGID1000Group ID for running containers as non-root

    Group ID for running containers as non-root

  • PUBLIC_URLPublic URL for reverse proxy setups

    Public URL for reverse proxy setups

  • PUID1000User ID for running containers as non-root

    User ID for running containers as non-root

  • VITE_ALLOWED_HOSTSAllowed hosts for Vite dev server

    Allowed hosts for Vite dev server

  • VITE_API_URLBrowser-reachable API URL for direct/LAN mode

    Browser-reachable API URL for direct/LAN mode

  • WEB_IMAGEshotgunwilly555/makersvault-web:latestDocker image for the web frontend

    Docker image for the web frontend

  • WEB_PORT5173Port the web UI listens on

    Port the web UI listens on

MakersVault releases & version history

More in 3D Printing

Rate this project

Click to rate — no account needed.

0 comments

Posting as guest
Loading comments…