Repolode
perber

perber/leafwiki

Self-hosted wiki that runs as a single Go binary with SQLite and Markdown files on disk, no external database needed.

Open-source alternative to:ConfluenceNotion

Stars
1,218
Forks
102
Open issues
48
Last commit
19 hours ago

What is it?

LeafWiki is a self-hosted wiki for structured, long-lived documentation such as runbooks, engineering notes and homelab docs. It ships as one Go binary with SQLite for metadata and page content stored as Markdown files in a data directory, so there is no Node.js, Redis or Postgres to operate. Pages are organized in an explicit tree with manual ordering, and backups are a copy of the data directory with the app stopped.

The editor provides live preview, keyboard shortcuts and autocomplete for internal links, and pages support tags, full-text search, backlinks and broken-link auditing. Markdown extras include tables, task lists, callouts, collapsible blocks, Mermaid diagrams, KaTeX math and embedded PDFs. Access can be fully internal, public read with login-only editing, or open without login, with admin, editor and viewer roles.

Optional features such as revision history, link rewriting on rename, SMTP email, Git backup and reverse-proxy header authentication are enabled through flags. The UI ships in English, German and Spanish.

Key features

  • 01Ships as a single Go binary with SQLite; page content is plain Markdown on disk.
  • 02Tree navigation with manual page ordering, tags, full-text search and backlinks.
  • 03Built-in Markdown editor with live preview and internal link autocomplete.
  • 04Three access modes: fully internal, public read, or open editing, with admin, editor and viewer roles.
  • 05Optional revision history, link rewriting on rename, SMTP email and Git backup.
  • 06Runs on Linux, macOS, Windows and Raspberry Pi, with Docker and systemd installers.

Use cases

  • Maintaining team runbooks and engineering notebooks in a structured tree.
  • Hosting internal documentation or a homelab knowledge base without a database server.
  • Providing a structured wiki UI over an existing Markdown or Obsidian vault.
  • Running a public documentation site where readers browse freely but only editors can change pages.

Quick start

  1. 1

    Run LeafWiki with Docker

    docker run -p 8080:8080 -v ~/leafwiki-data:/app/data ghcr.io/perber/leafwiki:latest --jwt-secret=yoursecret --admin-password=yourpassword --allow-insecure=true
  2. 2

    Open http://localhost:8080 in your browser and log in as admin

Things to know

  • API keys are still in development and not yet ready for use.
  • Git backup is experimental.
  • Real-time collaborative editing is not supported.

In collections

Topics

FAQ

What is leafwiki?
Self-hosted wiki that runs as a single Go binary with SQLite and Markdown files on disk, no external database needed. LeafWiki is a self-hosted wiki for structured, long-lived documentation such as runbooks, engineering notes and homelab docs. It ships as one Go binary with SQLite for metadata and page content stored as Markdown files in a data directory, so there is no Node.js, Redis or Postgres to operate. Pages are organized in an explicit tree with manual ordering, and backups are a copy of the data directory with the app stopped.
Is leafwiki free to use? What license does it have?
leafwiki is open source under the MIT license. Check the license terms before using it in commercial products.
Is leafwiki still maintained?
Actively maintained. The last commit to leafwiki was on Nov 6, 2026.
What can I use leafwiki for?
Maintaining team runbooks and engineering notebooks in a structured tree. Hosting internal documentation or a homelab knowledge base without a database server. Providing a structured wiki UI over an existing Markdown or Obsidian vault. Running a public documentation site where readers browse freely but only editors can change pages.
How do I install leafwiki?
Run LeafWiki with Docker: docker run -p 8080:8080 -v ~/leafwiki-data:/app/data ghcr.io/perber/leafwiki:latest --jwt-secret=yoursecret --admin-password=yourpassword --allow-insecure=true Open http://localhost:8080 in your browser and log in as admin
Where can I get leafwiki?
The source code and installation instructions are on GitHub: https://github.com/perber/leafwiki

Summary generated by AI from the project's README. GitHub stats refresh daily.

Related projects