Makershelf

Overview

makershelf Server for Unraid — 3D print file and project manager for makers, workshops and teams. Organise models, track filament, manage your printer farm and maintenance schedules. Note: this is a beta release. Please report issues on GitHub. Before starting: install a PostgreSQL container from Community Apps (search "postgres"), create a database named "makershelf" with a dedicated user, then fill in the PostgreSQL Connection field below. On first launch, open the Web UI and follow the setup wizard to create your workspace and first admin account.

Requirements

PostgreSQL server

Runtime arguments

Web UI: http://[IP]:[PORT:8080]/
Network: bridge
Shell: bash
Privileged: false

Template configuration

Web UI PortPorttcp

Port for the web interface. Leave as 8080 when using a dedicated container IP.

Target: 8080
Default: 8080
Value: 8080

AppDataPathrw

AppData folder for configuration and runtime files.

Target: /config
Default: /mnt/user/appdata/makershelf
Value: /mnt/user/appdata/makershelf

Project StoragePathrw

Folder where imported project files are stored permanently.

Target: /storage
Default: /mnt/user/Makershelf/Projects
Value: /mnt/user/Makershelf/Projects

Import FolderPathrw

Drop files or library folders here. The server scans this folder for bulk import without a browser upload.

Target: /import
Default: /mnt/user/Makershelf/Import
Value: /mnt/user/Makershelf/Import

Internal App PortVariable

Port the app listens on inside the container. Must match the Web UI Port when using a dedicated container IP.

Target: PORT
Default: 8080
Value: 8080

Session SecretVariable

Long random secret for login sessions. Generate one with: openssl rand -hex 32

Target: MAKERSHELF_AUTH_SECRET

PostgreSQL ConnectionVariable

PostgreSQL connection string. Format: postgresql://user:password@host:5432/database — must match the credentials you set up in your PostgreSQL container.

Target: DATABASE_URL
Default: postgresql://makershelf:change-me@makershelf-postgres:5432/makershelf
Value: postgresql://makershelf:change-me@makershelf-postgres:5432/makershelf

DATABASE_PROVIDERVariable

Default: postgresql
Value: postgresql

MAKERSHELF_PRODUCT_PROFILEVariable

Default: server
Value: server

MAKERSHELF_DEPLOYMENT_MODEVariable

Default: docker-team
Value: docker-team

MAKERSHELF_DATA_BACKENDVariable

Default: postgres
Value: postgres

MAKERSHELF_STORAGE_DRIVERVariable

Default: filesystem
Value: filesystem

MAKERSHELF_APPDATA_ROOTVariable

Default: /config
Value: /config

MAKERSHELF_STORAGE_ROOTVariable

Default: /storage
Value: /storage

MAKERSHELF_IMPORT_ROOTVariable

Default: /import
Value: /import

Links

Template Support GHCR Project

Details

Repository

ghcr.io/nilsn3dp/makershelf-server:beta

Registry

https://ghcr.io

Last Updated2026-06-02

First Seen2026-05-29

Run Makershelf on Unraid.

Makershelf is listed in Community Apps for Unraid OS. Explore Unraid to build a flexible home server, NAS, or homelab.

Explore Unraid OS