Self-hosting Jellybox
Jellybox is fully open source. You can host the server on your own infrastructure, build the physical device from off-the-shelf components, and 3D-print a case. This guide covers everything from first deployment to your first tag scan.
Deploy the server
Host the Jellybox web dashboard on Vercel with a Neon PostgreSQL database. Covers environment variables, Google OAuth, and email setup.
Self-host with Docker
Run the whole stack on your own hardware with the bundled Dockerfile and docker-compose.yml. Bundles Postgres, supports extension sidecars, no cloud account required.
Use & build extensions
Plug in any media source beyond Jellyfin by writing a small HTTP service. Covers the contract, OAuth, and the reference implementation.
Build the hardware
Full bill of materials and wiring guide for the ESP32, PN532 NFC reader, Waveshare eInk display, and NeoPixel LED ring.
Flash the firmware
Install Arduino IDE, add ESP32 board support, install the required libraries, and flash the firmware. Includes first-time device setup.
Print the case
Downloadable STL files for the Jellybox enclosure, designed to fit the ESP32 dev board, eInk display, and NFC module.