0 Fork 0

mirror of https://github.com/TautvydasDerzinskas/Thingport.git synced 2026-10-21 22:22:24 -05:00

Files

T

History

Tautvydas Derzinskas a7a91902a0 feat: add MyMiniFactory as a provider

Import, collection import and synced collections from MyMiniFactory, alongside MakerWorld,
Printables and Thingiverse.

- Backend: API v2 client with an instance-wide API key for metadata, collections and
  authors; files from MyMiniFactory's own download links (free models need no login).
  Paid models, and free ones whose files are archives, download as the user from their
  MyMiniFactory library through their session (PHPSESSID), fetching the model files
  MyMiniFactory unpacked from each archive. Paid models are left out of collection
  listings and syncs.
- One migration: MyMiniFactory category ids, username and session columns, plus a data
  migration giving existing users' starter categories the new category ids. Category
  matching now prefers the most specific site category.
- Frontend: provider everywhere the others appear (badges, Configuration and
  Administration providers, sync Browse tab, user menu, link detection, System Health,
  category ids), shared instance-key form for Thingiverse and MyMiniFactory, en and lt.
- Thingport Grab: new provider sites are allowed once from the popup (optional
  all-sites access, content script registered at runtime), so adding one never makes
  the browser disable the extension; captures the signed-in MyMiniFactory username and
  session; paid-model notice.
- Docs, website, store assets and screenshots updated.

2026-10-18 18:19:43 +02:00

.env.example

feat(flaresolverr): make URL configurable in admin settings

2026-10-11 19:34:29 +02:00

docker-compose.yml

docs: update docs and site (#50 )

2026-10-17 05:59:03 +02:00

icon.png

docs: add CasaOS install guide

2026-09-14 04:27:15 +02:00

README.md

feat: add MyMiniFactory as a provider

2026-10-18 18:19:43 +02:00

README.md

Running Thingport on CasaOS

Thingport is a 4-container stack (Postgres, FlareSolverr, backend, frontend) that talk to each other by container name -- the frontend's nginx config, for example, proxies /api/* straight to http://backend:8000. CasaOS's App Store is built around single-container "customized apps" with a compose editor underneath, so the easiest paths are either pasting the full stack into that editor or running compose yourself over SSH.

Option A: Install a customized app

App Store -> Install a customized app (the "+" / custom install button, wording varies slightly by CasaOS version) -> switch to the Docker Compose / YAML editor.
Paste in docker-compose.yml from this folder.
Copy .env.example into the environment variables section and fill in:
- AUTH_SECRET -- any random string, e.g. openssl rand -hex 32 from a terminal
- POSTGRES_PASSWORD -- any password
Install/submit the form.

Option B: Plain `docker compose` over SSH

SSH into CasaOS and create a folder for the stack, e.g. under /DATA/AppData/thingport.
Copy docker-compose.yml and .env.example into it, renaming the latter to .env and filling in the same values listed in Option A.
From inside that folder, run:
```
docker compose up -d
```

Either way, Thingport creates two folders on first start: /DATA/AppData/thingport/postgres (database) and /DATA/AppData/thingport/storage (your imported models) -- CasaOS's conventional appdata location, so they show up in the Files app alongside your other apps' data.

Open it

Once all 4 containers show healthy/running, open http://<your-casaos-ip>:<WEB_PORT> (default port 80). If you used Option A, CasaOS should also pick up the exposed port and add a dashboard tile for it automatically; if not, add one manually from the app's settings. The first account you register becomes the admin account.

Then open Administration → Overview → System Health and click Run full test. Everything marked Required or Recommended should be green; anything that isn't means part of Thingport won't work until it's fixed. See System Health.

Notes

Do not rename the backend service/container. The frontend's nginx config resolves it by that exact name over the compose network; renaming it breaks /api/* requests.
If the backend can't write to /DATA/AppData/thingport/storage, check that folder's owning uid/gid and set PUID/PGID in your .env to match.
Provider setup (MakerWorld / Thingiverse / MyMiniFactory credentials) works the same as any other install -- see docs/PROVIDER_SETUP.md in the main repo.
To pin a specific build instead of :latest, see the tagging note in docker-compose.deploy.yml and set BACKEND_IMAGE/ FRONTEND_IMAGE accordingly (add those two env vars to the stack and swap the image: lines to ${BACKEND_IMAGE:-...} / ${FRONTEND_IMAGE:-...} if you want that flexibility).

README.md

Running Thingport on CasaOS

Option A: Install a customized app

Option B: Plain docker compose over SSH

Open it

Notes

Option B: Plain `docker compose` over SSH