silverbullet/website/Install/Deno Deploy.md

Warning

Experimental This setup is not battle-tested, use it at your own risk

You can deploy SilverBullet to Deno Deploy for free, and store space content in Deno KV. This is a convenient option to deploy SilverBullet in the cloud, without having to run or pay for a server.

Steps

Sign up for a (free) Deno Deploy account and “Create an empty project” there.

Jump to the “Settings”, give your project a nicer name, and configure the following environment variables:

• SB_FOLDER: db://
• SB_PORT: 8000
• SB_SYNC_ONLY: 1 (Deno Deploy does not currently support Workers, so running indexing etc. on the server will not work)
• SB_USER: (e.g. pete:letmein) — this is super important otherwise your space will be open to anybody without any authentication
• SB_AUTH_TOKEN: (Optional) If you would like to migrate existing content from elsewhere (e.g. a local folder) using Sync, you will want to configure an authentication token here (pick something secure).

Make sure you have installed Deno locally on your machine.

Then, install deployctl via:

$ deno install -Arf https://deno.land/x/deploy/deployctl.ts

To deploy, run:

$ deployctl deploy -p=your-project --entrypoint=https://silverbullet.md/silverbullet.js --include= --prod

This will ask you to authenticate with your Deno Deploy account, and then deploy SilverBullet.

Migrating and backing up content

This setup stores you Spaces content in Deno’s KV database, which is still a beta feature and not specifically designed for this purpose. Therefore it’s recommended to use something like Sync to make backups elsewhere.

For this, be sure to also configure a SB_AUTH_TOKEN variable.