LeafWiki: Wiki in a Single Go Binary

handfuloflight1 pts0 comments

LeafWiki – A wiki for people who think in folders, not feeds<br>v0.11.3 · MIT license · community-supported · ★ 622<br>A real wiki app without the heavy stack.<br>For people who think in folders, not feeds. LeafWiki gives you a structured wiki for runbooks, homelab docs, tutorials, and team notes — Markdown on disk, no database server required.<br>Single Go binary — no Node.js, no Redis, no Postgres<br>Markdown files on disk — readable without the app, easy to back up<br>Runs on Linux, macOS, Windows, and Raspberry Pi<br>★ View on GitHub<br>Try the Demo →

Try the Demo →

Don't want to run the server yourself? Free hosted beta — 10 spots, starting September 2026.<br>Get a beta spot →

Content Spotlight<br>selfh.st weekly<br>Featured in<br>Self-Hosted Weekly

"Not every team needs a knowledge base with a Postgres cluster behind it. The 'SQLite plus files plus one container' approach is perfect for small teams and homelabs who want a wiki they can back up by copying a folder. I like tools that know their scope and stay there."<br>— Michael Soto, Self-Hosted Weekly

Works well for<br>Personal knowledge bases and engineering notes<br>Team runbooks, internal docs, onboarding guides<br>Homelab and self-hosted setups<br>Obsidian users who want a server-side wiki — [[wikilinks]] work out of the box<br>Anyone who prefers tree structure over a flat note feed

Probably not for you if<br>You need real-time collaborative editing<br>You need an all-in-one workspace like Notion or a full enterprise suite like Confluence<br>You need approval workflows or automations<br>You have a large org with complex permission requirements<br>It's intentionally focused. That's the point.

Editor<br>Write and see the result, side by side.<br>LeafWiki's editor shows your Markdown and the rendered output next to each other, live. No switching views, no preview button. What you're writing is visible as it will appear.<br>Auto-save — changes are saved automatically, no button to click<br>Paste images with Ctrl+V — uploaded and linked automatically<br>[[wikilink]] syntax — Obsidian-compatible, autocompletes as you type

Markdown on Disk<br>Your pages are plain files. Always.<br>Page content is stored as .md files on disk — readable in any editor, searchable with grep, movable without export. Metadata like links, tags, and the search index live in lightweight SQLite databases next to the files.<br>Open any page in your editor of choice — no app required<br>Backup is cp -r — no database dump, no special tooling<br>Move to another tool later without losing your content

data directory<br>data/<br>root/<br>index.md<br>getting-started.md<br>homelab/<br>index.md<br>network.md<br>server-setup.md<br>.order.json<br>.order.json<br>assets/

Navigation & Search<br>Always know where things are.<br>Tree navigation keeps your structure visible at all times. Full-text search with tag filtering (Ctrl+Shift+F) finds pages across the entire wiki fast. Quick navigation (Ctrl+Alt+P) gets you anywhere without reaching for the mouse.

Revision History<br>Nothing gets lost.<br>Every save is stored. If something breaks or gets overwritten, find the last good version and restore it in one click.<br>Enabled with --enable-revision.

Link Intelligence<br>Rename a page. Links update automatically.<br>LeafWiki tracks backlinks across the wiki. When you rename or move a page, existing links are updated automatically. Broken links are flagged per page so nothing silently falls apart.<br>Link refactoring enabled with --enable-link-refactor.

Diagrams & Math<br>Mermaid and KaTeX, inline.<br>Write Mermaid code blocks and they render as diagrams. KaTeX handles math notation. Both work inline in regular Markdown pages — no plugins or build steps.

Three ways to run it<br>Private wiki<br>Login required for all access. Default for team-internal wikis, homelab documentation, and anything that should stay private.

Public docs site<br>Anyone can read without an account. Only authenticated editors can make changes. For open project documentation, public runbooks, or community wikis.

Local notepad<br>No authentication. Everyone who can reach the server can read and edit. For solo use, trusted home networks, or a quick local knowledge base.

Works behind Authentik, Authelia, and Keycloak via trusted HTTP headers — plug into your existing auth setup.

Quick start<br>Docker<br>Copy<br>docker run -p 8080:8080 \<br>-v ~/leafwiki-data:/app/data \<br>ghcr.io/perber/leafwiki:latest \<br>--jwt-secret=secret \<br>--admin-password=admin \<br>--allow-insecure=true

Script (Ubuntu / Raspberry Pi OS)<br>Copy<br>sudo /bin/bash -c \<br>"$(curl -fsSL https://raw.githubusercontent.com/perber/leafwiki/main/install.sh)"

Linux x86_64<br>Linux arm64 (Raspberry Pi)<br>Windows<br>macOS (Apple Silicon)<br>macOS (Intel)<br>Full installation docs →

Why it exists<br>If you've looked at Wiki.js or Outline and thought "this is too much to operate for what I need" — this could fit for you.<br>I wanted a wiki for notes I might still need years from now. Not one that turns documentation into another fragile system to maintain or locks content into a format that is hard to move later.<br>Most self-hosted wikis need a database server and a...

wiki leafwiki without server markdown files

Related Articles