TautvydasDerzinskas/Thingport

Collect, organize, preview, and manage your 3D printing models from the places where you discover them.

stars

commits

TypeScript

primary language

Sep 13, 2026

updated

README

Your personal 3D model library.

Collect, organize, preview, and manage your 3D printing models
from the places where you discover them.

About

If you do 3D printing, you probably discover models across MakerWorld, Printables, Thingiverse, and other 3D model platforms.

Over time, those bookmarks, downloads, ZIP files, and random folders become a mess.

Thingport is your personal, self-hosted 3D model library.

Bring your models together in one place, keep them organized, and preview them directly in your browser.

Instead of having your collection scattered across different websites and your filesystem, Thingport gives you a single place to manage the models you actually want to keep.

Features

🗂️ Personal model library — keep your 3D models in one organized place
🌐 Import from model websites — bring models into your library from supported platforms
🔎 Search & organize — find models in your collection quickly
🧊 3D previews — inspect models directly in the browser
📦 Archive your models — keep local copies of the models you want to preserve
🖼️ Model metadata & previews — keep useful information together with the files
🔗 Source links — retain the original model source
🐳 Self-hosted — run your own instance and keep your collection under your control
🌍 Multi-language ready — internationalization support built into the frontend
⚡ Modern web interface — React + Three.js powered UI

Screenshots

_Dashboard	_Models	_{Model Details}
_{3D Preview}	_Collections	_Tags
_Downloads	_{My Models}	_{Dark Theme}
_{Thingport Grab — Printables}	_{Thingport Grab — Thingiverse}	_{Thingport Grab — MakerWorld}

Companion Apps

Thingport ships two small companion tools, each downloadable from the in-app Download page or GitHub Releases:

Thingport Bridge — a lightweight desktop helper that makes "Open in {Slicer}" work for slicers (Bambu Studio, PrusaSlicer, Cura) whose own URL-protocol handlers won't accept a link from a self-hosted domain.
Thingport Grab — a Chrome extension that imports MakerWorld, Thingiverse, and Printables models straight from their own pages, without leaving the site (see the screenshots above).

Provider Setup

Printables imports work with no setup. MakerWorld and Thingiverse each need a credential from your own account first -- see docs/PROVIDER_SETUP.md for how to create a Thingiverse Access Token and how to grab a MakerWorld session cookie.

Installation

Docker Compose

Runs entirely from the pre-built images on GHCR -- no local build, no git clone needed. Works on any Docker host, including a NAS (Synology, QNAP, Unraid, etc).

Create a folder for Thingport and add these two files to it:

docker-compose.yml

services:
  db:
    image: postgres:16-alpine
    restart: unless-stopped
    environment:
      - POSTGRES_USER=${POSTGRES_USER:-thingport}
      - POSTGRES_PASSWORD=${POSTGRES_PASSWORD:-thingport}
      - POSTGRES_DB=${POSTGRES_DB:-thingport}
    volumes:
      - thingport_db:/var/lib/postgresql/data
    networks:
      - app-net
    healthcheck:
      test: ["CMD-SHELL", "pg_isready -U ${POSTGRES_USER:-thingport}"]
      interval: 5s
      timeout: 5s
      retries: 10

  flaresolverr:
    image: ghcr.io/flaresolverr/flaresolverr:latest
    restart: unless-stopped
    environment:
      - LOG_LEVEL=${FLARESOLVERR_LOG_LEVEL:-info}
      - TZ=${TZ:-UTC}
    networks:
      - app-net

  backend:
    image: ghcr.io/tautvydasderzinskas/thingport-backend:latest
    restart: unless-stopped
    environment:
      - PUID=${PUID:-1000}
      - PGID=${PGID:-1000}
      - INITIAL_ADMIN_EMAIL=${INITIAL_ADMIN_EMAIL:-}
      - AUTH_SECRET=${AUTH_SECRET:-changeme-secret}
      - AUTH_TOKEN_TTL=${AUTH_TOKEN_TTL:-43200}
      - PUBLIC_URL=${PUBLIC_URL:-}
      - SMTP_HOST=${SMTP_HOST:-}
      - SMTP_PORT=${SMTP_PORT:-587}
      - SMTP_SECURE=${SMTP_SECURE:-false}
      - SMTP_USER=${SMTP_USER:-}
      - SMTP_PASS=${SMTP_PASS:-}
      - SMTP_FROM=${SMTP_FROM:-Thingport <no-reply@localhost>}
      - FILE_STORAGE=/app/storage
      - DATABASE_URL=postgresql://${POSTGRES_USER:-thingport}:${POSTGRES_PASSWORD:-thingport}@db:5432/${POSTGRES_DB:-thingport}?schema=public
      - CORS_ORIGINS=${CORS_ORIGINS:-}
      - FLARESOLVERR_URL=${FLARESOLVERR_URL:-http://flaresolverr:8191/v1}
    depends_on:
      db:
        condition: service_healthy
      flaresolverr:
        condition: service_started
    volumes:
      - thingport_storage:/app/storage
    networks:
      - app-net

  frontend:
    image: ghcr.io/tautvydasderzinskas/thingport-frontend:latest
    restart: unless-stopped
    ports:
      - "${WEB_PORT:-80}:80"
    depends_on:
      - backend
    networks:
      - app-net

volumes:
  thingport_storage:
  thingport_db:

networks:
  app-net:
    driver: bridge

.env

# Required
# AUTH_SECRET signs login tokens -- use your own random value
AUTH_SECRET=b1193c7014e833a063f750d6e4644d615e90e6ee81dbde619e1818e9675a3374
# the first account to register with this email becomes admin
INITIAL_ADMIN_EMAIL=you@example.com
POSTGRES_PASSWORD=change-this-password

# Optional (defaults shown)
PUID=1000
PGID=1000
WEB_PORT=80
POSTGRES_USER=thingport
POSTGRES_DB=thingport
# e.g. https://thingport.example.com -- needed for links in verification emails
PUBLIC_URL=
# login token lifetime, in seconds
AUTH_TOKEN_TTL=43200
SMTP_HOST=
SMTP_PORT=587
SMTP_SECURE=false
SMTP_USER=
SMTP_PASS=
SMTP_FROM=Thingport <no-reply@localhost>
FLARESOLVERR_URL=http://flaresolverr:8191/v1
TZ=UTC

Then start it:

docker compose up -d

Thingport will be available at http://<host>:<WEB_PORT> (default port 80).

Building from source instead

git clone https://github.com/TautvydasDerzinskas/Thingport.git
cd Thingport
cp .env.example .env
docker compose up -d

This builds the images locally rather than pulling from GHCR.

Support

If Thingport is useful to you, consider supporting its development:

Contributors

TautvydasDerzinskas

91 commits

See what people are saying

Hacker News (1)

Thingport – a self-hosted web that pulls your 3D model collection into one place

1 points · Sep 13, 2026

Similar repos

calibrain/shelfmark

3,878

booklore-app/booklore

BookLore: A self-hosted, multi-user digital library with smart shelves, auto metadata, Kobo &…

1,144

grimmory-tools/grimmory

A self-hosted library for your ebooks, comics, and audiobooks

4,313

AlbertAmat/vaultisse

Vaultisse helps you organize all your books — whether they’re at home, school, or work. Easily keep…

StepaniaH/port-light

A web dashboard that shows your server's port usage as a traffic-light grid. Built for homelabbers…

sysadminsmedia/homebox

A continuation of HomeBox the inventory and organization system built for the Home User

7,146

portainer/portainer

Making Docker and Kubernetes management easy.

38,492

jiangrui1994/CloudSaver

一个基于 Vue 3 + Express 的网盘资源搜索与转存工具。

9,290

Languages

TypeScript

91.0%

JavaScript

6.0%

1.7%

TautvydasDerzinskas/Thingport

Collect, organize, preview, and manage your 3D printing models from the places where you discover them.

stars

commits

TypeScript

primary language

Sep 13, 2026

updated

README

Your personal 3D model library.

Collect, organize, preview, and manage your 3D printing models
from the places where you discover them.

About

If you do 3D printing, you probably discover models across MakerWorld, Printables, Thingiverse, and other 3D model platforms.

Over time, those bookmarks, downloads, ZIP files, and random folders become a mess.

Thingport is your personal, self-hosted 3D model library.

Bring your models together in one place, keep them organized, and preview them directly in your browser.

Instead of having your collection scattered across different websites and your filesystem, Thingport gives you a single place to manage the models you actually want to keep.

Features

🗂️ Personal model library — keep your 3D models in one organized place
🌐 Import from model websites — bring models into your library from supported platforms
🔎 Search & organize — find models in your collection quickly
🧊 3D previews — inspect models directly in the browser
📦 Archive your models — keep local copies of the models you want to preserve
🖼️ Model metadata & previews — keep useful information together with the files
🔗 Source links — retain the original model source
🐳 Self-hosted — run your own instance and keep your collection under your control
🌍 Multi-language ready — internationalization support built into the frontend
⚡ Modern web interface — React + Three.js powered UI

Screenshots

_Dashboard	_Models	_{Model Details}
_{3D Preview}	_Collections	_Tags
_Downloads	_{My Models}	_{Dark Theme}
_{Thingport Grab — Printables}	_{Thingport Grab — Thingiverse}	_{Thingport Grab — MakerWorld}

Companion Apps

Thingport ships two small companion tools, each downloadable from the in-app Download page or GitHub Releases:

Thingport Bridge — a lightweight desktop helper that makes "Open in {Slicer}" work for slicers (Bambu Studio, PrusaSlicer, Cura) whose own URL-protocol handlers won't accept a link from a self-hosted domain.
Thingport Grab — a Chrome extension that imports MakerWorld, Thingiverse, and Printables models straight from their own pages, without leaving the site (see the screenshots above).

Provider Setup

Installation

Docker Compose

Runs entirely from the pre-built images on GHCR -- no local build, no git clone needed. Works on any Docker host, including a NAS (Synology, QNAP, Unraid, etc).

Create a folder for Thingport and add these two files to it:

docker-compose.yml

services:
  db:
    image: postgres:16-alpine
    restart: unless-stopped
    environment:
      - POSTGRES_USER=${POSTGRES_USER:-thingport}
      - POSTGRES_PASSWORD=${POSTGRES_PASSWORD:-thingport}
      - POSTGRES_DB=${POSTGRES_DB:-thingport}
    volumes:
      - thingport_db:/var/lib/postgresql/data
    networks:
      - app-net
    healthcheck:
      test: ["CMD-SHELL", "pg_isready -U ${POSTGRES_USER:-thingport}"]
      interval: 5s
      timeout: 5s
      retries: 10

  flaresolverr:
    image: ghcr.io/flaresolverr/flaresolverr:latest
    restart: unless-stopped
    environment:
      - LOG_LEVEL=${FLARESOLVERR_LOG_LEVEL:-info}
      - TZ=${TZ:-UTC}
    networks:
      - app-net

  backend:
    image: ghcr.io/tautvydasderzinskas/thingport-backend:latest
    restart: unless-stopped
    environment:
      - PUID=${PUID:-1000}
      - PGID=${PGID:-1000}
      - INITIAL_ADMIN_EMAIL=${INITIAL_ADMIN_EMAIL:-}
      - AUTH_SECRET=${AUTH_SECRET:-changeme-secret}
      - AUTH_TOKEN_TTL=${AUTH_TOKEN_TTL:-43200}
      - PUBLIC_URL=${PUBLIC_URL:-}
      - SMTP_HOST=${SMTP_HOST:-}
      - SMTP_PORT=${SMTP_PORT:-587}
      - SMTP_SECURE=${SMTP_SECURE:-false}
      - SMTP_USER=${SMTP_USER:-}
      - SMTP_PASS=${SMTP_PASS:-}
      - SMTP_FROM=${SMTP_FROM:-Thingport <no-reply@localhost>}
      - FILE_STORAGE=/app/storage
      - DATABASE_URL=postgresql://${POSTGRES_USER:-thingport}:${POSTGRES_PASSWORD:-thingport}@db:5432/${POSTGRES_DB:-thingport}?schema=public
      - CORS_ORIGINS=${CORS_ORIGINS:-}
      - FLARESOLVERR_URL=${FLARESOLVERR_URL:-http://flaresolverr:8191/v1}
    depends_on:
      db:
        condition: service_healthy
      flaresolverr:
        condition: service_started
    volumes:
      - thingport_storage:/app/storage
    networks:
      - app-net

  frontend:
    image: ghcr.io/tautvydasderzinskas/thingport-frontend:latest
    restart: unless-stopped
    ports:
      - "${WEB_PORT:-80}:80"
    depends_on:
      - backend
    networks:
      - app-net

volumes:
  thingport_storage:
  thingport_db:

networks:
  app-net:
    driver: bridge

.env

# Required
# AUTH_SECRET signs login tokens -- use your own random value
AUTH_SECRET=b1193c7014e833a063f750d6e4644d615e90e6ee81dbde619e1818e9675a3374
# the first account to register with this email becomes admin
INITIAL_ADMIN_EMAIL=you@example.com
POSTGRES_PASSWORD=change-this-password

# Optional (defaults shown)
PUID=1000
PGID=1000
WEB_PORT=80
POSTGRES_USER=thingport
POSTGRES_DB=thingport
# e.g. https://thingport.example.com -- needed for links in verification emails
PUBLIC_URL=
# login token lifetime, in seconds
AUTH_TOKEN_TTL=43200
SMTP_HOST=
SMTP_PORT=587
SMTP_SECURE=false
SMTP_USER=
SMTP_PASS=
SMTP_FROM=Thingport <no-reply@localhost>
FLARESOLVERR_URL=http://flaresolverr:8191/v1
TZ=UTC

Then start it:

docker compose up -d

Thingport will be available at http://<host>:<WEB_PORT> (default port 80).

Building from source instead

git clone https://github.com/TautvydasDerzinskas/Thingport.git
cd Thingport
cp .env.example .env
docker compose up -d

This builds the images locally rather than pulling from GHCR.

Support

If Thingport is useful to you, consider supporting its development:

See what people are saying

Hacker News (1)

Thingport – a self-hosted web that pulls your 3D model collection into one place

1 points · Sep 13, 2026

Similar repos

calibrain/shelfmark

3,878

booklore-app/booklore

BookLore: A self-hosted, multi-user digital library with smart shelves, auto metadata, Kobo &…

1,144

grimmory-tools/grimmory

A self-hosted library for your ebooks, comics, and audiobooks

4,313

AlbertAmat/vaultisse

Vaultisse helps you organize all your books — whether they’re at home, school, or work. Easily keep…

StepaniaH/port-light

A web dashboard that shows your server's port usage as a traffic-light grid. Built for homelabbers…

sysadminsmedia/homebox

A continuation of HomeBox the inventory and organization system built for the Home User

7,146

portainer/portainer

Making Docker and Kubernetes management easy.

38,492

jiangrui1994/CloudSaver

一个基于 Vue 3 + Express 的网盘资源搜索与转存工具。

9,290

Contributors

TautvydasDerzinskas

91 commits

Languages

TypeScript

91.0%

JavaScript

6.0%

1.7%