MakersVault Unraid Templates

Community templates for deploying MakersVault on Unraid.

What is MakersVault?

MakersVault is a self-hosted 3D print file management system that helps you organize, preview, and manage your 3D printing files.

Features

• 3D Model Preview: View STL, 3MF, STEP, OBJ files directly in your browser
• File Organization: Create folders, add tags, and organize your collection
• Auto-Import: Automatically scan and catalog existing files from network shares
• Search & Filter: Find files quickly by name, tags, or folder
• Dark/Light Mode: Switch themes for better visibility of different colored models
• Web-Based: Access from any device on your network

Supported File Types

3D Models: STL, 3MF, STEP, STP, OBJ
Images: SVG, PNG, JPG, JPEG, WEBP, BMP
Archives: ZIP

Installation

⚠️ IMPORTANT: This documentation contains example IP addresses and domain names for illustration. See IMPORTANT_README_PLACEHOLDERS.md for details about replacing placeholders with your actual values. The templates are pre-configured with generic defaults that work for most users.

Via Community Applications (Recommended)

1. Open Unraid WebUI
2. Go to Apps tab
3. Search for "MakersVault"
4. Install MakersVault-API first
5. Install MakersVault-UI second
6. Configure and access via web browser

Manual Installation

Add this repository to your Unraid template sources:

Docker → Add Container → Template repositories
Add URL: https://github.com/mallison01/unraid-makersvault-templates

Then install both containers from the dropdown.

Quick Setup

1. Install MakersVault-API (Backend)

Required Settings:

• Network: bridge (or br0 if you use custom networking)
• Port: 8000
• Change AUTH_PASSWORD and AUTH_SECRET

Important: Generate a secure secret:

openssl rand -hex 32

2. Install MakersVault-UI (Frontend)

Required Settings:

• Network: Same as API (bridge or br0)
• Port: 5173
• Set VITE_API_URL to match your API access

3. Access MakersVault

• Default: http://localhost:5173 (if accessing from Unraid server)
• Network Access: http://[SERVER_IP]:5173
• Via Proxy: https://your-domain.com

Default Login: admin / super-secret (change this!)

Configuration

Basic Setup (Direct Access)

API Container:

AUTH_PASSWORD=YourSecurePassword
AUTH_SECRET=<generated-from-openssl-rand>
CORS_ORIGINS=http://[UI_IP]:5173
PUID=99
PGID=100

UI Container:

VITE_API_URL=http://[API_IP]:8000
VITE_ALLOWED_HOSTS=[UI_IP]
PUID=99
PGID=100

Advanced Setup (With Reverse Proxy)

See docs/HAPROXY_CONFIG.md for HAProxy configuration.

API Container:

CORS_ORIGINS=https://your-domain.com

UI Container:

VITE_API_URL=https://your-domain.com/api
VITE_ALLOWED_HOSTS=your-domain.com

Auto-Import Feature

MakersVault can automatically scan and import existing 3D files from a network share:

1. Mount your 3D files directory to /imports in the API container
2. Set IMPORT_MOUNT_ON_STARTUP=true (default)
3. Container will scan and catalog files on startup

Example:

Host Path: /mnt/user/3d-files
Container Path: /imports
Mode: Read-only

Files remain in their original location - MakersVault just catalogs them!

Documentation

• Setup Guide - Complete installation and configuration
• Environment Variables - All configuration options
• HAProxy Configuration - Reverse proxy setup
• Permissions Guide - File ownership and permissions

Requirements

• Unraid 6.9+ (tested on 6.12)
• Docker enabled
• Minimum 2GB RAM recommended
• Storage space for database and previews

Architecture

┌─────────────────┐
│  Web Browser    │
└────────┬────────┘
         │
         ↓
┌─────────────────┐      ┌─────────────────┐
│ MakersVault-UI  │ ←──→ │ MakersVault-API │
│   (Port 5173)   │      │   (Port 8000)   │
└─────────────────┘      └────────┬────────┘
                                  │
                                  ↓
                         ┌─────────────────┐
                         │  3D Files (NAS) │
                         │   /imports      │
                         └─────────────────┘

Troubleshooting

Login fails / CORS errors

Check that CORS_ORIGINS in API matches where your browser accesses the UI:

• If accessing at http://192.168.1.100:5173, use: CORS_ORIGINS=http://192.168.1.100:5173
• If accessing at https://your-domain.com, use: CORS_ORIGINS=https://your-domain.com

"Invalid Host header" error

Add your hostname to VITE_ALLOWED_HOSTS:

VITE_ALLOWED_HOSTS=192.168.1.100,your-domain.com

Files have wrong permissions

Ensure both containers have:

PUID=99
PGID=100

Then fix existing files:

chown -R nobody:users /mnt/user/makersvault/

Import not working

Check:

1. /imports volume is mounted
2. IMPORT_MOUNT_ON_STARTUP=true
3. Files match extensions in IMPORT_MOUNT_EXTS
4. Check logs: docker logs MakersVault-API

Support

• MakersVault Project: https://github.com/VincentCinque/MakersVault
• Template Issues: https://github.com/mallison01/unraid-makersvault-templates/issues
• Unraid Forums: Support Thread

Contributing

Found a bug or have a suggestion? Please open an issue!

Credits

• MakersVault: Created by Vincent Cinque
• Docker Images: shotgunwilly555
• Unraid Templates: Community contribution

License

These templates are provided as-is for community use.
MakersVault is licensed under MIT - see the official repository for details.

---

⭐ If you find these templates helpful, please star this repository!