---
title: "Deploy SilverBullet: Self-Hosted Markdown Notes & Knowledge Base"
description: "Write, link and query Markdown notes in your own private wiki."
category: "Other"
url: https://railway.com/deploy/silverbullet-markdown
---

# Deploy SilverBullet: Self-Hosted Markdown Notes & Knowledge Base

Write, link and query Markdown notes in your own private wiki.

**[Deploy SilverBullet: Self-Hosted Markdown Notes & Knowledge Base on Railway](https://railway.com/template/silverbullet-markdown)**

Machine-readable deploy manifest (JSON, validated by TemplateCI): https://railway.com/deploy/silverbullet-markdown/manifest.json

- **Creator:** blueorange
- **Category:** Other

## Template content

### silverbullet https://cdn.jsdelivr.net/gh/homarr-labs/dashboard-icons/png/silverbullet.png

- **Image:** ghcr.io/silverbulletmd/silverbullet
- **Public domain:** Yes

## Documentation

# Deploy and Host SilverBullet on Railway

![SilverBullet logo](https://github.com/silverbulletmd.png)

SilverBullet is an open source **Markdown note-taking app and personal knowledge base** that runs in the browser. Every page is a plain `.md` file in a folder you own, and SilverBullet adds live preview editing, wiki links with backlinks, tasks, templates and an object index you can query like a database. Space Lua, its built-in scripting language, lets you build your own commands, widgets and dashboards right inside your notes. Recent releases added multi-space hosting with user accounts, single sign-on and revision history. SilverBullet is MIT licensed with about 6,600 GitHub stars, and 2.12.1 shipped in October 2026; this template follows the latest image. It deploys SilverBullet on Railway with a persistent volume for your notes. Notion Plus costs about $10–12 per user per month (approximate), and Obsidian Sync is a paid add-on. SilverBullet on Railway usually costs about $5/month for a private notes server you can open from any device.

---

## What This Template Deploys

| Service | Purpose |
|---|---|
| **silverbullet** | `ghcr.io/silverbulletmd/silverbullet`, the web app and server on port `3000` with a public domain. Volume at `/data`, with the server folder at `/data/space`. |

There is no database. Notes are Markdown files on the volume, and SilverBullet keeps its index, accounts and settings in the same folder.

---

## Important: Finish the Setup Wizard Right Away

Current SilverBullet versions start in **multi-space mode**. With an empty data folder, the first visit opens a setup wizard that creates the first administrator account and your first space. **Until you complete it, anyone who opens your URL could create that admin account.**

Open your Railway domain as soon as the deploy is healthy and finish both steps. The template's `SB_ADMIN_USERNAME`, `SB_ADMIN_PASSWORD` and `SB_SPACE_NAME` variables are not read by current SilverBullet, so the generated password is not your login; choose your own password in the wizard. You can delete those three variables afterwards.

---

## About Hosting SilverBullet

Most note apps keep your writing in a proprietary format on someone else's servers. SilverBullet keeps every page as Markdown on your own volume, so your notes stay readable by any editor, easy to back up and free of lock-in.

**Live preview Markdown.** Write in Markdown and see formatting, links, tables and images rendered as you type, with an optional Vim mode.

**Links and backlinks.** Connect pages with wiki links, see linked mentions on every page, and create pages simply by linking to them.

**Objects and queries.** Pages, tasks, tags and frontmatter become indexed objects. Query them to build live lists, such as open tasks, recent meetings or project pages.

**Space Lua.** Write small Lua scripts inside your notes to add commands, slash commands, widgets and custom views.

**Templates and journals.** Use page templates for meeting notes, daily journals and project pages.

**Works offline.** Install it as a progressive web app; it keeps a local copy in the browser and syncs changes when you reconnect.

**Accounts and spaces.** Host several spaces on one server, each with its own address and access rules, and invite people with read or write roles.

---

## Deploy SilverBullet in Under 5 Minutes

1. Click **Deploy on Railway**. No inputs are needed.
2. Wait for the health check to pass, then **open the SilverBullet domain immediately**.
3. In the setup wizard, create your administrator account with a strong password.
4. Create your first space, bound at `/` so it opens at the root of your domain.
5. Start writing. Install it as an app from your browser to use it offline.

---

## Common Use Cases

- **Personal knowledge base:** a private second brain of linked notes you own.
- **Daily journal:** dated pages with templates and links to people and projects.
- **Task tracking:** tasks spread across pages, gathered by queries into one list.
- **Project wiki:** documentation for a side project or small team.
- **Meeting notes:** templates for agendas and decisions, linked to each project.
- **Research notes:** collect sources and ideas with tags and backlinks.
- **Recipes and reading lists:** structured pages queried into collections.
- **Custom dashboards:** Lua widgets that summarize your notes.

---

## Configuration

| Variable | Default | Description |
|---|---|---|
| `PORT` | `3000` | Port Railway routes the public domain to; SilverBullet listens on 3000 |
| `SB_FOLDER` | `/data/space` | Server folder on the volume for spaces, accounts and settings |
| `SB_ADMIN_USERNAME` | `admin` | Not read by current SilverBullet; safe to remove |
| `SB_ADMIN_PASSWORD` | 🔐 Auto-generated | Not read by current SilverBullet; safe to remove |
| `SB_SPACE_NAME` | `My Space` | Not read by current SilverBullet; safe to remove |
| `RAILWAY_DEPLOYMENT_DRAINING_SECONDS` | `10` | Time to finish writes during redeploys |

**Accounts and access.** Manage accounts, spaces and access levels in the SilverBullet dashboard. Each space can allow no access, read access or write access for visitors without an account.

**Single sign-on.** Connect Google Workspace, Pocket ID or another OpenID Connect provider from the dashboard.

**Custom domain.** Add your domain to the service in Railway and bind a space to it in the dashboard if you host more than one.

**Revisions.** SilverBullet can keep page revision history in the data folder, so you can restore earlier versions of a page.

**Backups.** Everything lives on the `/data` volume. Back up the volume, or sync your space to a Git repository for an off-site copy.

**Editing outside SilverBullet.** Pages are plain Markdown files, so you can copy them out and open them in any editor if you ever move on.

**Upgrades.** The template uses the latest image, so a redeploy can pick up a new release. Back up the volume before upgrading and read the release notes.

**Resources.** SilverBullet is a single small binary. A few hundred megabytes of memory suits most personal knowledge bases.

---

## Ideas for Organizing Your Space

**Tag everything lightly.** Add tags such as `#meeting`, `#book` or `#project` to pages and tasks. Tags become object types you can query later, so a little tagging pays off quickly.

**Use frontmatter for structure.** Give pages fields like status, owner or due date in a short YAML block at the top. Queries can then filter and sort pages by those fields.

**Build an index page.** Make your home page a dashboard with live queries for open tasks, recently changed pages and active projects, so every visit starts with what matters.

**Template repeated pages.** Create templates for meeting notes, weekly reviews and project pages so new pages start with the right headings and fields.

**Keep pages small and linked.** Short pages joined by links are easier to find and reuse than one long document, and backlinks show where each idea is used.

---

## SilverBullet vs. Alternatives

| Feature | SilverBullet on Railway | Obsidian | Notion | Logseq |
|---|---|---|---|---|
| Hosting | Self-hosted | Desktop app | Hosted SaaS | Desktop app |
| License | MIT | Proprietary | Proprietary | AGPL-3.0 |
| Plain Markdown files | ✅ | ✅ | ❌ | ✅ |
| Works in any browser | ✅ | ❌ | ✅ | ❌ |
| Queries over notes | ✅ | Plugins | Databases | ✅ |
| Built-in scripting | Lua | Plugins | ❌ | Plugins |
| Price | About $5/month | Free, paid sync | About $10–12/user/month | Free |

Obsidian has a huge plugin ecosystem. Notion is strong for team databases. Logseq is an outliner with local files. SilverBullet gives you a scriptable Markdown wiki in the browser, on your own server.

---

## Dependencies for SilverBullet Hosting

- A Railway account.

### Deployment Dependencies

- [SilverBullet on GitHub](https://github.com/silverbulletmd/silverbullet): source code and releases
- [SilverBullet documentation](https://silverbullet.md/): manual, Space Lua and queries
- [SilverBullet Docker image](https://github.com/silverbulletmd/silverbullet/pkgs/container/silverbullet): image tags

### Implementation Details

The image runs a single SilverBullet binary with a health check on `/.instance`. Notes, the index, accounts and settings live in the server folder on the volume, so redeploys keep everything.

---

## Frequently Asked Questions

**What is SilverBullet?**
An MIT-licensed open source Markdown notes app and knowledge base that runs in your browser, with queries and Lua scripting.

**How much does it cost to host?**
Usually about $5/month on Railway for the service and its volume.

**How do I log in the first time?**
Open your domain right after deploying and create the admin account in the setup wizard.

**Why doesn't the generated admin password work?**
Current SilverBullet does not read `SB_ADMIN_PASSWORD`. Your login is the account you create in the wizard.

**Can I use it offline?**
Yes. Install it as a web app and it keeps working offline, syncing when you reconnect.

**Are my notes locked in?**
No. Every page is a plain Markdown file on the volume.

---

## Why Deploy and Host SilverBullet on Railway?

Railway is a singular platform to deploy your infrastructure stack. Railway will host your infrastructure so you don't have to deal with configuration, while allowing you to vertically and horizontally scale it.

By deploying SilverBullet on Railway, you get a private, scriptable Markdown knowledge base you can open from any device, with every note in a folder you own.


## Similar templates

- [Rocky Linux](https://railway.com/deploy/rocky-linux) — Hosted Rocky Linux 9 workspace with SSH and persistent storage. 🚀
- [Foundry Virtual Tabletop](https://railway.com/deploy/X5tR6G) — Self-hosted virtual tabletop for role-playing games (license required)
- [Double Commander in your browser](https://railway.com/deploy/double-commander-in-your-browser) — The Double Commander file manager in the cloud, from any device

Open this page in a browser: https://railway.com/deploy/silverbullet-markdown
