Repository navigation
Backplane v0.12.0
Backplane 0.12.0 is the desktop app: an Electron window over the Backplane hub (backplane-serve), on Linux (x64, arm64), macOS (Apple silicon) and Windows (x64). The native Bend window is gone.
Install
- Linux and macOS:
curl -fsSL https://github.com/i2cjak/Backplane/releases/download/v0.12.0/install.sh | sh. This installs the hub, its web client, thebackplanecommand and the desktop app into~/.local/share/backplane. SetBACKPLANE_NO_DESKTOP_APP=1for a hub-only install, for example on a server. - Debian and Ubuntu:
backplane_0.12.0_amd64.debor_arm64.debinstalls into/opt/backplaneand sets up the app's sandbox for you. - Windows: unzip
backplane-v0.12.0-windows-x64.zipand runBackplane.exe. - Portable desktop archives:
backplane-v0.12.0-<platform>.tar.gz(runbackplane-openon Linux, orBackplane.appon macOS).
backplane opens the desktop app when there's a display. backplane --headless runs the hub in the background, as before.
Linux sandbox
The desktop app runs inside Chromium's OS sandbox and never turns it off. That sandbox needs either user namespaces or a root-owned chrome-sandbox. Ubuntu 23.10 and later restrict user namespaces.
- The .deb sets this up automatically.
- With install.sh or the tarball, if neither is available, the installer and the app print the one command to run, for example:
sudo chown root:root ~/.local/share/backplane/desktop/runtime/chrome-sandbox && sudo chmod 4755 ~/.local/share/backplane/desktop/runtime/chrome-sandbox
Updating from 0.11
- Installs from install.sh update themselves. The updater installs the new hub, its web client and the
backplanecommand. Until you run install.sh once,backplaneopens the hub in your browser instead of a window. - To get the desktop app, run the install command above once.
- .deb installs: install the 0.12.0 .deb.
Not in this build
- Part renders on the Mech tab, and agents' PNG renders. The Mech tab says so; the 3D view still shows parts.
- The embedded CEF browser.
- The full text of launch reports cut short by earlier versions.
- The user-interface fixes that came after this build: Chat as the uberbot's first tab, no Subagents panel for it, no stray extra-text panel, multi-file image upload, and operational reports filed in the Mailroom. These are in 0.12.1.
Phones
The Android and iOS apps in this release were built as 0.12.0 earlier in the cycle, from source 920c5a39. They don't include the user-interface fixes above, which come with 0.12.1.
Build
Built from 7fc9d098, with CI green on that exact tree (type-check, proofs, tests, server builds and smoke). Each desktop archive passed a launch-and-connect check on its own platform, with the OS sandbox on: hosted Linux x64, Linux arm64 and macOS runners, and a Windows VM.