Skip to content

Backplane v0.12.0

Choose a tag to compare

@i2cjak i2cjak released this 21 Oct 23:19
· 1372 commits to 7fc9d09851703b43088d1f3a7438bd7db49a2fba since this release

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, the backplane command and the desktop app into ~/.local/share/backplane. Set BACKPLANE_NO_DESKTOP_APP=1 for a hub-only install, for example on a server.
  • Debian and Ubuntu: backplane_0.12.0_amd64.deb or _arm64.deb installs into /opt/backplane and sets up the app's sandbox for you.
  • Windows: unzip backplane-v0.12.0-windows-x64.zip and run Backplane.exe.
  • Portable desktop archives: backplane-v0.12.0-<platform>.tar.gz (run backplane-open on Linux, or Backplane.app on 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 backplane command. Until you run install.sh once, backplane opens 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.