75 lines
2.7 KiB
Markdown
75 lines
2.7 KiB
Markdown
---
|
||
tags: getting-started
|
||
references:
|
||
- bin/silverbullet/src/main.rs
|
||
- bin/silverbullet/build.rs
|
||
---
|
||
|
||
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)
|
||
* FreeBSD (x86_64)
|
||
|
||
> **note** Which file should I download?
|
||
> The [releases page](https://github.com/silverbulletmd/silverbullet/releases) lists two families of zip files:
|
||
> * `silverbullet-server-<os>-<arch>.zip`: **this is what you want**, the actual SilverBullet server.
|
||
> * `sb-<os>-<arch>.zip` — the optional [[CLI]] tool (`sb`) for scripting against a _running_ server.
|
||
|
||
# Steps
|
||
We start by [downloading the `silverbullet-server-*` zip for your platform from GitHub](https://github.com/silverbulletmd/silverbullet/releases).
|
||
|
||
Unzip this archive somewhere convenient. You’ll get a single `silverbullet` executable.
|
||
|
||
Then, create a folder to hold your data (your server configuration and space files will live here):
|
||
|
||
```bash
|
||
mkdir sb-data
|
||
```
|
||
|
||
Run the server, pointing it at that folder:
|
||
```bash
|
||
./silverbullet sb-data
|
||
```
|
||
|
||
Since `sb-data` is empty, this opens a first-run setup wizard for accounts and your first space — see [[Space Manager]]. Point the server at a folder that already holds pages instead, and it’s served immediately as a classic single space.
|
||
|
||
The server listens on `http://localhost:3000` by default. To pick a different port, use `-p`:
|
||
```bash
|
||
./silverbullet -p 3001 my-space
|
||
```
|
||
|
||
And to bind on an address other than `127.0.0.1` (e.g. to make it reachable on your LAN), use `-L`:
|
||
```bash
|
||
./silverbullet -L 0.0.0.0 my-space
|
||
```
|
||
|
||
To force classic single-space behavior add `--single`:
|
||
```bash
|
||
./silverbullet --single my-space
|
||
```
|
||
|
||
> **note** Note
|
||
> If you want to access SilverBullet from another machine, you need [[TLS]] _and_ you should enable [[Authentication]] first.
|
||
|
||
Now, open `http://localhost:3000` in your browser and you’ll be guided through the initial [[Space Manager]], once that’s all done, head to [[Getting Started]] to learn the basics.
|
||
|
||
# Upgrading
|
||
You can upgrade your SilverBullet install based on the version you’d like to run.
|
||
|
||
To upgrade to the latest **stable** release:
|
||
```bash
|
||
./silverbullet upgrade
|
||
```
|
||
|
||
To upgrade to the latest **edge** release (which keeps in sync with the `main` development branch):
|
||
```bash
|
||
./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.
|