Skip to content

Installation (Unraid and Docker)

Jump to bottom
Systemedic edited this page May 22, 2026 · 1 revision

Installation

Installing GyroidVault is pretty straight forward, especially if you're using Unraid. It's built as a standard Docker container.

Unraid Setup (Recommended)

You can find GyroidVault directly in the Community Applications (CA) app store on your Unraid server. Just search for "GyroidVault" and click install.

Volume Mappings

The most critical part of the setup is getting your volume mappings right. GyroidVault needs to know where your models live.

  1. AppData (/app/data): This is where GyroidVault stores its SQLite database, settings, and generated thumbnails. Just leave this at the default (/mnt/user/appdata/gyroidvault).
  2. Library (/library): This is important! Point this to the root folder of your 3D models. For example, if you store all your STL files in a share called 3Dprints, map this to /mnt/user/3Dprints.

GyroidVault will scan this directory and all its subfolders. It does not modify your actual files, it just reads them.

Standard Docker Run

If you're not using Unraid, you can spin it up with a simple docker run command:

docker run -d \
  --name=gyroidvault \
  -p 3000:3000 \
  -v /path/to/your/appdata:/app/data \
  -v /path/to/your/models:/library \
  ghcr.io/teecodedev/gyroidvault:latest

Once it's running, open your browser and navigate to http://<your-server-ip>:3000. The first time it boots, it might take a minute to scan a very large library, so give it a sec!

Clone this wiki locally