Skip to content
View in the app

A better way to browse. Learn more.

Unraid

A full-screen app on your home screen with push notifications, badges and more.

To install this app on iOS and iPadOS
  1. Tap the Share icon in Safari
  2. Scroll the menu and tap Add to Home Screen.
  3. Tap Add in the top-right corner.
To install this app on Android
  1. Tap the 3-dot menu (⋮) in the top-right corner of the browser.
  2. Tap Add to Home screen or Install app.
  3. Confirm by tapping Install.

[Support] GyroidVault - 3D model library and print manager

Featured Replies

Application Name: GyroidVault

GitHub Repository: GyroidVault

Unraid Template: GyroidVault.xml


About GyroidVault

GyroidVault is a self-hosted, lightweight 3D model manager designed for 3D printing enthusiasts. It acts as a blazing fast, locally hosted alternative to platforms like Printables or MakerWorld, giving you full control over your files without relying on cloud services.

Key Features

  • Fast & Local: Built to handle massive libraries with thousands of files directly on your Unraid array. No cloud dependency.

  • Built-in 3D Viewer: Instantly preview your STL and 3MF files directly in your browser.

  • "Send to Slicer" Integration: Open files directly in Bambu Studio, PrusaSlicer, Orca Slicer and others with a single click.

  • Organization: Categorize your models with custom tags, categories, and collections (projects).


Installation & Setup

GyroidVault is designed to map directly to your existing 3D model library folder on your Unraid server.

Volume Mappings

  • /app/data (Appdata): Used for the SQLite database, generated thumbnails, and configuration.

  • /app/data/library (Library): Map this to the root folder where all your 3D printing models (STL, 3MF, etc.) are stored.

IMPORTANT

GyroidVault reads your files directly from the /app/data/library path. Make sure this mapping points to the correct location of your 3D models.


Support & Bug Reports

If you encounter any bugs or have feature requests, please drop a message in this thread or open an issue on the GitHub Repository.

When reporting an issue, please include your Unraid Version and any relevant logs from the container.

Unraid template is incorrect. Library is mapped in the container to /library instead of /app/data/library where the app is looking.

Now that that's fixed lets stress test this baby with 2.3TB of stls!

Edited by roofuskit

  • Author

@roofuskit Aah, yes! Thank you for pointing that out. First time creating an Unraid Template...

Oh my, that is a serious stress test! Good to know that in the coming update (hope to push it after the weekend) folder view (browse your collection as is on the drive) will be live and persistant navigation!

7 hours ago, DutchTee86 said:

@roofuskit Aah, yes! Thank you for pointing that out. First time creating an Unraid Template...

Oh my, that is a serious stress test! Good to know that in the coming update (hope to push it after the weekend) folder view (browse your collection as is on the drive) will be live and persistant navigation!

Looking forward to the update, I manually added a STL and I really like the way GyroidVault displays STLS with the render.
I also appreciate that your also a gyroid enjoyer :)

It appears that custom categories dont show in the dropdown menu.
I created a 'Planters' category but I'm unable to move anything into it.

EDIT: After restarting the docker container its populated. Good to know nevertheless.

image.png

Edited by ayrtoo

  • Author

Had a day off yesterday so I was able to push an update just now. The categories cache was a small thing so I made a quick fix and added in this release. @ayrtoo

Library scan not seeming to work. I have it mapped to an NFS remote share that has all my 3D files, but scan library shows nothing.

  • Author

@The_Holocron I guess it has something to do with rights, is the docker log showing anything after pushing the scan button?

The container is running with PUID and PGID 99, you can try changing your NFS share to the same or adjust the container.

Edited by DutchTee86

7 minutes ago, DutchTee86 said:

@The_Holocron I guess it has something to do with rights, is the docker log showing anything after pushing the scan button?

Permissions, right. Always permissions. I will need to check that.
Log:
✓ Database initialized

GyroidVault running on http://0.0.0.0:3000

Starting background library scanner (interval: 24 hours)

[Scanner] Start library scan: /app/data/library

[Scanner] Scan voltooid. Modellen: 0, Bestanden: 0, Overgeslagen: 0

[Scanner] Start library scan: /app/data/library

[Scanner] Scan voltooid. Modellen: 0, Bestanden: 0, Overgeslagen: 0

[Scanner] Start library scan: /app/data/library

[Scanner] Scan voltooid. Modellen: 0, Bestanden: 0, Overgeslagen: 0

✓ Database synchroon weggeschreven (shutdown).

✓ Database initialized

GyroidVault running on http://0.0.0.0:3000

Starting background library scanner (interval: 24 hours)

[Scanner] Start library scan: /app/data/library

[Scanner] Scan voltooid. Modellen: 0, Bestanden: 0, Overgeslagen: 0


I figured it out. The template was still pointing to the /library and not /app/data/library internally as noted in the post above:
image.png

Edited by The_Holocron

  • Author

@The_Holocron 🙄Sorry I left the docker logs in Dutch. Will fix that.

I alsno noticed a fault in my Unraid Template, quick fix and perhaps that will solve your issue;

Create a new Variable

Name: LIBRARY_PATH

Key: LIBRARY_PATH

Value: /library

Restart the docker and see if it works :-).

I fixed it by changing the value in the template. It is what was noted above.

For me, that worked fine ! I have some question regarding how the folders must be organize and how can you integrate with klipper or something like that for tracking filaments since there is a UI part for this.

  • Author

@Watever Hi,

In GyroidVault, a Folder on your disk is treated as a single Model in the database. Any .stl or .3mf files inside that folder are grouped together under that one Model. This is why it's highly recommended to organize your files into subfolders (e.g., Library/Vase/vase.stl) rather than putting all .stl files directly into the root folder. I've just updated the Wiki documentation to make this file structure clearer for new users!

Regarding the Bambu 3MF files: Bambu Studio injects custom, data into their 3MF files that standard web 3D viewers cannot easily render. Because of this, GyroidVault will extract and display the static 2D thumbnail picture embedded inside the Bambu 3MF file, but it cannot render the full interactive 3D preview. Standard STL files and generic 3MF files will render in full 3D perfectly though! Something I will look into for the future.

As for being able to manually select which file serves as the main preview when there are multiple files in a folder: great idea, I have added it to the roadmap; https://github.com/users/TeeCodeDev/projects/1

  • 2 weeks later...

@DutchTee86 Hi,
am i Missing something or is there no username / Password for logging in ? Cause i get none, and can´t seem to make one

  • Author

@CromAr Yes! Due to the new user management the register option is hidden...Also for the first user..Great bug catch! I fixed this and pushed a hottfix. Please update the container!

4 minutes ago, DutchTee86 said:

@CromAr Yes! Due to the new user management the register option is hidden...Also for the first user..Great bug catch! I fixed this and pushed a hottfix. Please update the container!

Great :) Works now :) Thx

Join the conversation

You can post now and register later. If you have an account, sign in now to post with your account.
Note: Your post will require moderator approval before it will be visible.

Guest
Reply to this topic...

Account

Navigation

Search

Search

Configure browser push notifications

Chrome (Android)
  1. Tap the lock icon next to the address bar.
  2. Tap Permissions → Notifications.
  3. Adjust your preference.
Chrome (Desktop)
  1. Click the padlock icon in the address bar.
  2. Select Site settings.
  3. Find Notifications and adjust your preference.