Self-host GitBook

Documentation hosting / knowledge base · Category: wiki, docs & notes

GitBook is a hosted docs-as-a-product platform — block-based editor, git sync, AI search, branded domain. The self-hostable replacements split into two camps: WYSIWYG knowledge bases (BookStack, Outline) and Markdown static-site generators (Docusaurus, MkDocs) that target docs-as-code.

GitBook pricing anchor: Free for open source; Plus $8/user/mo; Premium $15/user/mo; Ultimate custom.

BookStack BookStackApp/BookStack alive

GitHub: ★ 18.8k · last commit 1d ago · 0 open issues
License: MIT
Setup time: 20min docker-compose (PHP/Laravel + MariaDB)
Monthly cost: $5/mo VPS for a small team.

Migration sketch. Pull `lscr.io/linuxserver/bookstack` and `lscr.io/linuxserver/mariadb`. BookStack uses a Books → Chapters → Pages hierarchy that maps cleanly to GitBook's Spaces → Groups → Pages. Migrate via the GitBook Markdown export (Settings → Export → Git): clone the resulting git repo, then use BookStack's API or the community `gitbook-bookstack-importer` to bulk-create books. Images come over via the Markdown image references.

Good fit forInternal knowledge bases — wikis, runbooks, onboarding docs — where editors prefer a WYSIWYG over Markdown files.

Weak atNot git-backed by design; if your editorial culture is PR review on docs, Docusaurus fits better.

Docusaurus facebook/docusaurus alive

GitHub: ★ 64.9k · last commit today · 380 open issues
License: MIT
Setup time: 10min `npx create-docusaurus`
Monthly cost: $0-5 — Docusaurus builds static HTML; deploy free on Vercel/Netlify/Cloudflare Pages, or $3/mo VPS with nginx.

Migration sketch. Run `npx create-docusaurus@latest my-docs classic`. GitBook export → git → drop the .md files into `docs/` — Docusaurus picks them up. Images live alongside; rewrite GitBook-specific block syntax (hints, tabs) to Docusaurus's MDX equivalents. Docs are git-versioned; every change is a PR.

Good fit forEngineering docs, OSS project sites, API references — anywhere docs-as-code is the workflow.

Weak atNon-developer editors find Markdown-in-git unfriendly; no WYSIWYG admin UI.

Outline outline/outline alive

GitHub: ★ 38.4k · last commit today · 62 open issues
License: BSL-1.1
BSL converts to Apache-2.0 after 4 years; self-host of unmodified source is permitted.
Setup time: 30min docker-compose (Outline + Postgres + Redis + S3-compatible blob)
Monthly cost: $10/mo VPS + small storage budget for attachments.

Migration sketch. Use the official compose at docs.getoutline.com. GitBook export as Markdown → drag the unzipped folder onto Outline's import. Outline's collection-document hierarchy maps to GitBook spaces; rich-text blocks translate cleanly because both rest on a Prosemirror-style model. SSO via Google/Microsoft OAuth out of the box.

Good fit forMixed editor / engineer teams that want collaborative real-time editing and a polished web UI close to GitBook's feel.

Weak atNot git-versioned at the file level; built-in revision history serves audit needs but isn't PR-shaped.

In a terminal? npx os-alt gitbook prints this table — how the CLI works →