zefhemel/silverbullet repository overview

⁠Silver Bullet

Silver Bullet (SB) is an extensible, open source personal knowledge platform. At its core it’s a clean markdown-based writing/note taking application that stores your pages (notes) as plain markdown files in a folder referred to as a space. Pages can be cross-linked using the [[link to other page]] syntax. This makes it a simple tool for Personal Knowledge Management⁠. However, once you leverage its various extensions (called plugs) it can feel more like a knowledge platform, allowing you to annotate, combine and query your accumulated knowledge in creative ways specific to you.

⁠Installing Silver Bullet with Docker

There is a docker image on docker hub⁠. To use it, first create a volume to keep your space (markdown) files:

docker volume create myspace

Then, run the container, e.g. as follows:

docker run -p 3000:3000 -v myspace:/space -d --name silverbullet zefhemel/silverbullet

If you'd like to pass in additional command line arguments (e.g. --user to add authentication) you can just append those to the command, e.g.:

docker run -p 3000:3000 -v myspace:/space -d --name silverbullet zefhemel/silverbullet --user me:letmein

To build your own version of the docker image, run ./scripts/build_docker.sh.

You can also use docker-compose if you prefer. From a silverbullet check-out run:

PORT=3000 docker-compose up

or similar.

To upgrade, simply pull the latest docker image (rebuilt and pushed after every commit to "main") and start the new container.

docker pull zefhemel/silverbullet