docker-spoolease-bambustudio

Web-accessible SpoolEase Custom Bambu Studio running in a browser — a self-hosted, containerized slicer with integrated SpoolEase filament management.

This image packages yanshay's SpoolEase fork of Bambu Studio, built on the linuxserver/docker-bambustudio Selkies web-desktop base, with the upstream Bambu Studio build swapped for the SpoolEase fork.

Quick start

Unraid

Search SpoolEase-BambuStudio in Community Applications and click Install.

docker run

docker run -d \
  --name spoolease-bambustudio \
  -e PUID=99 \
  -e PGID=100 \
  -e TZ=Europe/Zurich \
  -p 3001:3001 \
  --shm-size=1gb \
  -v /path/to/config:/config \
  --restart unless-stopped \
  ghcr.io/tda90/spoolease-bambustudio:latest

compose

services:
  spoolease-bambustudio:
    image: ghcr.io/tda90/spoolease-bambustudio:latest
    container_name: spoolease-bambustudio
    environment:
      - PUID=99
      - PGID=100
      - TZ=Europe/Zurich
    volumes:
      - /path/to/config:/config
    ports:
      - 3001:3001
    shm_size: "1gb"
    restart: unless-stopped

Parameters

Tags: :latest tracks the newest build; each release is also published under its fork version, e.g. :2.8.2.61-spoolease.1, if you prefer to pin.

Access

Served over HTTPS only. Open https://<host-ip>:3001 and accept the self-signed certificate warning.

Connecting a printer

Bambu Studio discovers printers via mDNS/SSDP broadcast, which does not cross Docker's bridge network. To connect a LAN-only printer, add it manually by IP:

Device → "Bind with Access Code" → enter the printer's IP address and access code (shown on the printer under Settings → LAN Only).

If the printer is on a separate VLAN, ensure the host can route to it. For automatic discovery, run the container with host networking on the printer's subnet.

Updating

[!IMPORTANT] Back up /config before updating across a major Bambu Studio version. Studio migrates its configuration forward on first start, and that migration is one-way — rolling the image back afterwards may not cleanly read the migrated config. Filament presets, flow ratios and calibration data live here.

tar czf spoolease-studio-config-$(date +%F).tgz -C /path/to config

How this image is built

• The SpoolEase fork version is pinned in the Dockerfile as SPOOLEASE_TAG, the single source of truth — the CI workflow reads it from there to label the image and derive its tag, so the two cannot drift apart.
• The AppImage is SHA256-verified at build time and the build fails closed if the hash does not match.
• Upstream publishes AppImages for several Ubuntu releases; the build requires exactly one asset to match the pinned target and aborts otherwise, rather than silently taking whichever came first.

Notes

• Unofficial, community-maintained. Not affiliated with Bambu Lab. The SpoolEase fork is maintained by yanshay.
• Bambu Studio's beta-update prompt is disabled in this image, so it won't offer to replace the SpoolEase fork with upstream Bambu Studio.
• Behaviour is otherwise identical to the upstream linuxserver/bambustudio image.

Credits

• SpoolEase and the Bambu Studio fork by yanshay
• Base image: linuxserver/docker-bambustudio
• Bambu Studio by Bambu Lab (AGPL-3.0)

License

AGPL-3.0, matching upstream Bambu Studio.

Acknowledgements & disclosure

This container packaging and its CI pipeline were assembled with AI assistance (Claude) — the Dockerfile adaptation, the build workflow, and the configuration tweaks. It is a community packaging effort and is provided as-is; please review before use.

All credit for the actual application belongs to yanshay, who created and maintains the SpoolEase project and the SpoolEase Bambu Studio fork that this image runs. This repository only packages that work into a container; it does not modify the slicer itself beyond disabling the upstream beta-update prompt to prevent the fork being overwritten.

If you find SpoolEase useful, support the original project rather than this packaging repo.