SilverBullet is distributed as a single server binary available for the following platforms:

  • macOS (Intel and Apple Silicon) (platform name “darwin”)
  • Linux (x86_64 and arm64) (note that this will run on Raspberry Pi as well, but requires a 64-bit Linux distribution)
  • Windows (64-bit)

Steps: 1. Download the binary for your platform from Github. 2. Unzip the file in a convenient place 3. Run it from the command line (see below)

You need to create a folder to hold your Spaces|space files. This folder can be kept anywhere. You can then run silverbullet taking the folder path as an argument:

mkdir sb
./silverbullet sb

There are a bunch of Install/Configuration options you can pass, usually as environment variables.

MacOS security

SilverBullet binaries are not signed, therefore when you run silverbullet on macOS, it will likely refuse to run it.

To work around this, go into your Mac’s System Settings. In the Privacy & Security section, make sure you allow applications from App Store & Known Developers. If you’ve run silverbullet from the CLI already and failed, you’ll see it listed here with an option to override. Select that option and run it again from the CLI, you should now have an addition “Run anyway” button. Click it, authenticate and from this point all should be good.

Upgrading

You can upgrade your SilverBullet install based on the version you’d like to run.

To upgrade to the latest stable release:

./silverbullet upgrade

To upgrade to the latest edge release (which keeps in sync with the main development branch):

./silverbullet upgrade-edge

To upgrade your client, be sure to refresh your page twice somewhat slowly.

Version

To check which version of SilverBullet you’re running, run the ${widgets.commandButton("Client: Version")} command.