1
0
silverbullet/website/Install/Deno.md
2023-12-19 12:58:18 +01:00

2.0 KiB

The SilverBullet is implemented using a JavaScript runtime called Deno which is a lot like node.js, just... you know, better. And we like better.

To run SilverBullet directly on your host system (so not in a Install/Docker container), you need to install Deno first following these instructions.

After having installed Deno, run:

$ deno install -f --name silverbullet --unstable -A https://get.silverbullet.md

You only have to do this once. This will download the currently released version of SilverBullet onto your machine.

If you prefer to live on the bleeding edge, you can install using the following command instead:

$ deno install -f --name silverbullet --unstable -A https://silverbullet.md/silverbullet.js

Either command will install silverbullet into your ~/.deno/bin folder (which should already be in your $PATH if you followed the Deno install instructions).

While you have Install/Configuration, the most straightforward way is to simply use a folder on disk.

After creating a folder, run the following command in your terminal:

$ silverbullet <pages-path>

By default, SilverBullet will bind to port 3000; to use a different port, use the -p flag (e.g. -p8080).

For security reasons, by default, SilverBullet only allows connections via localhost (or 127.0.0.1). To also allow connections from the network, pass a -L0.0.0.0 flag (0.0.0.0 for all connections, or insert a specific address to limit the host), combined with --user username:password to add simple Authentication.

Once downloaded and booted, SilverBullet will print out a URL to open in your browser.

Upgrading

SilverBullet is regularly updated. To get the latest and greatest, simply run:

$ silverbullet upgrade

And restart SilverBullet. You should be good to go.

Deno itself is also updated regularly, so be sure to let that self-upgrade as well:

$ deno upgrade