Skip to content

Releases

Plum Box emulator 1.11.13

Choose a tag to compare

@plum-code plum-code released this 14 Nov 17:41

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

Choose a tag to compare

@plum-code plum-code released this 21 Sep 08:04

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.