Repository navigation
Releases
Plum Box emulator 1.11.13
The Plum Box emulator: a real Plum Box core you can run on your own machine, so you can build and test an app without owning a box.
plum-dev emulator up (plum-dev 0.2.0 or newer) downloads the binary for your platform, verifies it against SHA256SUMS, and runs it with PLUMBOX_EMULATOR=1 on 127.0.0.1. Docker is not required. To run it by hand:
chmod +x plum-server-<your platform>
PLUMBOX_EMULATOR=1 PLUMBOX_LISTEN_HOST=127.0.0.1 ./plum-server-<your platform> -port 8080 -data-dir ./plum-data -storage-dir ./plum-storage -dev-skip-mount-check
Then open http://127.0.0.1:8080 and sign in as the seeded owner (dev / plumbox-dev). A developer token is written to <data-dir>/emulator/pat.txt.
New in this build. The same core as boxes on 1.11.13 — companion clients with the files:app scope, hourly access tokens with refresh — plus one emulator-only change: with PLUMBOX_LISTEN_HOST=127.0.0.1 (what plum-dev passes) it listens on this machine only, so the seeded owner and its token are not reachable from your network. Support tickets are off in the emulator.
What differs from a box. Emulator mode uses mock isolation, skips the mount check, turns off BLE, Wi-Fi provisioning, the LAN certificate and the relay pool, leaves the Plum service URLs empty unless you set them, and accepts unsigned bundles so plum-dev push works without pairing. It also allows a host-architecture service binary, while the store still only accepts arm64 — plum-dev validate warns about that. A companion app's sign-in still needs a real box.
Terms. The Plum Box core is not open source. These binaries are published for local development against the Plum app platform. Redistribution and production use are not granted.
Built from core 1.11.13. Verify with sha256sum -c SHA256SUMS.
Plum Box emulator 1.11.1
The Plum Box emulator: a real Plum Box core you can run on your own machine, so you can build and test an app without owning a box.
plum-dev emulator up downloads the binary for your platform, verifies it against SHA256SUMS, and runs it with PLUMBOX_EMULATOR=1. Docker is not required. To run it by hand:
chmod +x plum-server-<your platform>
PLUMBOX_EMULATOR=1 ./plum-server-<your platform> -port 8080 -data-dir ./plum-data -storage-dir ./plum-storage
Then open http://localhost:8080 and sign in as the seeded owner (dev / plumbox-dev). A developer token is written to <data-dir>/emulator/pat.txt.
What differs from a box. Emulator mode uses mock isolation, skips the mount check, turns off BLE, Wi-Fi provisioning, the LAN certificate and the relay pool, leaves the Plum service URLs empty unless you set them, and accepts unsigned bundles so plum-dev push works without pairing. It also allows a host-architecture service binary, while the store still only accepts arm64 — plum-dev validate warns about that.
Terms. The Plum Box core is not open source. These binaries are published for local development against the Plum app platform. Redistribution and production use are not granted.
Built from core 1.11.1. Verify with sha256sum -c SHA256SUMS.