You are reading content from Scuttlebutt
@farewellutopia %WpfUnoVY+pdHlEKapuA7d3eIqsl1XLcqM/PeZw6goTU=.sha256

Easier installation

Step 1: Install the native messaging host with

npx scuttle-shell-browser

Step 2: Install the add-on in Firefox by downloading the xpi-file from here:

Step 3: Check out that it is working, go to and see if you can enable SSB access for that page (and if you do, please consider writing a review for the No. 6 BunaB).



  • Firefox >= 50
  • node.js >= 14
  • An ssb-server, e.g. Patchwork
@farewellutopia %S52zYMR7PedOgWF1Dl3D1GqJQtcJci2yLoLZalW8RAE=.sha256

Unfortunately this isn't yet working as it should. I've posted an issue with the library used for the platform specific installation. For now, you can use the following workaround.

Step 1 workaround: Clone the project, install, and run the setup-script

git clone
cd scuttle-shell-browser/
npm install
npm run-script setup:native-host
@farewellutopia %QqHraeMUCI7Sb8/zYG2ydry+e+jE9EEfbLx8eddQi4w=.sha256

While the original Step 1 with npx still doesn't work, the workaround has become a bit easier

Step 1: Install scuttle-shell-browser to install the native messaging host

npm install -g  scuttle-shell-browser

Step 2: Install the latest xpi-file in Firefox from

@farewellutopia %aPehGFXyrd6tfEbl9F5vD4JJgKiFFQtRUjkRhduo9cI=.sha256

Finally! npx scuttle-shell-browser installs the latest native messaging host.

(if you already installed scuttle-shell-browser globally, remove it with npm -g remove scuttle-shell-browser before running npx)

User has not chosen to be hosted publicly
@farewellutopia %qTwq2Z6i37atlWl3JDuMb9CTy1mZmzPlf0XFINhHw7Q=.sha256

@Powersource (phone)

I haven't yet been trying to integrate the ssb-browser-demo approach, but I think ideally the extension should support both approaches:

  • use a local ssb server if the user wants to use their existing identity in the browser
  • use an approach like ssb-browser-demo (storing the identity in the scope of the add-on) if the user has no local ssb-server, or doesn't want to use it.

We could also put ssb-browser-demo-style functionality in ssb-connect.js (the script used in the page) so that users without plugin could have an identity for that site (stored in localStorage).

So putting it all together, users of would have 3 options:

  1. Completely ignore Scuttlebutt, they use the site just like any other site that allows user to publish content. They ignore that behind the scenes a key-pair is created for them, that they joined, and that their public posts are accessible with Scuttlebutt clients.
  2. Install the Scuttle Shell Browser extension to share an identity among several sites, as well as to be able to join and leave pubs, and to backup their identity.
  3. Additionally install the Scuttle Shell Browser native messaging host to use the identity with other clients, and to benefit from the extended networking and storage capabilities of the local host.

What's quite nice is that the code using ssb-connect.js would not need to differentiate among these 3 scenarios, the library could take care of the differences, and download some more code if no extension is detected.

I'm personally not currently planning to work on these enhancements, but rather to write some apps that make use of the extension first, so #somebodycould

Join Scuttlebutt now