Self-host Wiki.js
3.4.0Open-source wiki engine with markdown and two-way Git sync
docker run -d -p 8080:3000 --name wiki --restart unless-stopped -e "[email protected]" -e "ADMIN_PASS=SuperSecret123" -e "DB_HOST=db" -e "DB_USER=wikijs" -e "DB_PASS=wikijsrocks" -e "DB_NAME=wiki" ghcr.io/requarks/wiki:3.0.0-beta- Stars
- 29 301
- RAM
- 1GB
- Port
- 3000 (HTTP / WebSocket port the wiki app listens on)
- Requires
- ltree / pg_trgm PostgreSQL extensions, PostgreSQL
ghcr.io/requarks/wikiWhat is Wiki.js?
Wiki.js is an open-source wiki engine aimed at teams that want their documentation kept in plain markdown they control. Its editor uses the Monaco code-editor base from VS Code and shows the rendered page beside what you type, with tables, tab groups, insertable live blocks (galleries, maps, PDF viewers, infoboxes) and diagrams or math generated from code fences. A single instance can serve many wikis, each on its own domain with separate appearance, languages, login setup and storage. Sign in with local accounts or delegate identity to OIDC, LDAP or SAML providers, mapping groups at login; rights are assigned per page path per group, readers may submit suggestions that reviewers accept or reject, revisions are diffed and rolled back with one click, and an audit log tracks activity. Pages can be kept in sync bidirectionally with a Git repo or exported to disk or to S3, Azure and GCP buckets, and the whole UI is driven by an OpenAPI-documented REST API. Operationally it is a Node.js application talking to PostgreSQL: official multi-arch images on ghcr.io plus a Helm chart cover containers, and tarballs cover Linux, macOS and Windows hosts where it listens on 3000 unless configured otherwise. Caveats: this repo is the 3.0 beta line and is explicitly not for production, it cannot live under a sub-folder of a domain, and subfolder-free setups behind a proxy require forwarded headers enabled.
Wiki.js alternatives
eziwikiA self-hosted Markdown wiki generator with built-in search, graph views, wiki links, and PDF embeds.Compareeziwiki with Wiki.js
outlineSelf-hosted team wiki and knowledge base with realtime collaborative editing, comments, search and 20+ integrations, run as a Docker container with PostgreSQL and Redis.Compareoutline with Wiki.js
deepwiki-openOpen-source, self-hosted generator that turns GitHub, GitLab or Bitbucket repositories into AI-written wiki docs with diagrams and RAG chat.Comparedeepwiki-open with Wiki.js
AlexandrieSelf-hosted, open-source alternative to Notion, Obsidian and Confluence: a team wiki with an advanced Markdown editor, offline PWA support, OIDC SSO and S3-based backups.CompareAlexandrie with Wiki.js
Wiki-GoOpen-source, self-hosted flat-file wiki in Go with Markdown editing, full-text search, version history, access rules, comments and kanban boards. No database needed.CompareWiki-Go with Wiki.js
docmostSelf-hosted, open-source collaborative wiki with real-time editing, diagrams, AI features, and enterprise SSO as a Confluence/Notion alternative.Comparedocmost with Wiki.js
yeswikiYesWiki is a self-hosted, open-source PHP wiki for collaborative sites with drag-and-drop forms, maps, calendars, and directory views.Compareyeswiki with Wiki.js
OpenKnowledgeOpen-source, self-hosted WYSIWYG markdown editor and LLM wiki with MCP agent editing, git-backed sync and team sharing.CompareOpenKnowledge with Wiki.js
Should you self-host Wiki.js?
Wiki.js scores 79/100 on selfhost.directory (how scoring works) and ranks #1 of 31 in Wikis. It has 29 301 GitHub stars, +268 in the last 30 days.
It shipped 15 stable releases in the past year. The latest, 3.4.0, came out on 15 November 2026. New versions land roughly every 3 days.
Setup is easy: most people get it running in one sitting. An official Docker image is available. It is AGPL-3.0-licensed and written mostly in Typescript.
Its closest alternative on selfhost.directory is outline (78/100, 41 275 stars). Wiki.js scores higher overall. See Wiki.js vs outline side by side.
Features
- Audit Log
- Content blocks
- Diagrams and math as code
- Edit approval workflow
- File Manager
- Full-Text Search
- Granular per-path permissions
- Markdown editor with live preview
- Multilingual content
- Multiple sites per instance
- Real-Time Collaboration
- REST API
- Two-way Git sync
- Version history with rollback
- Webhooks and background workers
Wiki.js README
- Official Website
- Documentation
- Requirements
- Installation
- Changelog
- Feature Requests
- Chat with us on Discord
- Translations (We need your help!)
Wiki.js is an open source project that has been made possible due to the generous contributions by community backers. If you are interested in supporting this project, please consider becoming a sponsor, becoming a patron, donating to our OpenCollective or via Paypal.
Support this project by becoming a sponsor. Your name and a link to your website will be listed on the backers page on the Wiki.js website! [Become a sponsor]
|
|
Alexander Casassovici (@alexksso) |
Broxen (@broxen) |
Dacon (@xDacon) |
Maxime Pierre (@DonNabla) |
|
|
|
Jay Daley (@JayDaley) |
Oleksii (@idokka) |
|
|
Shane Kearney (@shanekearney) |
|
Browserstack for providing access to their great cross-browser testing tools.
Cloudflare for providing their great CDN, SSL and advanced networking services.
Icons8 for providing access to their beautiful icon sets.
CrowdIn for providing access to their great localization tool.
Porkbun for providing domain registration services.
ProductBridge for providing access to their great feedback portal tool.
FAQ
Are pull requests with AI-generated code accepted?
Yes, provided a human has reviewed the entire change and takes responsibility for it; PRs clearly submitted by automated bots are rejected.
Are devcontainers required for development?
No, but they are recommended because they bundle all the needed dependencies, and many IDEs support them.
How are pages rendered for search engines?
Wiki.js is a single-page app, so unauthenticated requests such as search engines and bots get a prerendered response, which also serves as a fallback for users with JavaScript disabled.
Why can't I upload files larger than a certain size?
This is usually the reverse proxy in front of the wiki limiting request bodies, so its upload/body size configuration needs to be raised.
More in Wikis
wiki-serverA self-hosted, open-source Federated Wiki server in Node.js that enables collaborative writing across distributed wiki instances with plugin extensibility.- WiKissWiKiss is a lightweight, self-hosted wiki engine designed for simplicity and ease of deployment, requiring only PHP and no external database.
WorldLoomSelf-hosted offline worldbuilding and storywriting app with rich-text articles, maps, manuscripts, timelines, and HTML export. Node.js, file-based storage, no database.
XWikiSelf-hosted, open-source enterprise wiki written in Java: WYSIWYG editing, semantic annotations, advanced permissions, structured data and in-page server-side macros.
YellowSelf-hosted flat-file CMS for small websites, wikis and blogs. Runs on PHP 7.0+ with no database, uses Markdown, extensible with plugins and themes.
yeswikiYesWiki is a self-hosted, open-source PHP wiki for collaborative sites with drag-and-drop forms, maps, calendars, and directory views.
AlexandrieSelf-hosted, open-source alternative to Notion, Obsidian and Confluence: a team wiki with an advanced Markdown editor, offline PWA support, OIDC SSO and S3-based backups.
amusewikiSelf-hosted wiki engine using Emacs Muse markup with Git backend, multi-site support, EPUB/PDF output via LaTeX, OPDS server, and bookbuilder.
An Otter WikiA minimalistic wiki powered by python, markdown and git.
BookStackOpen-source, self-hosted documentation wiki built with PHP and MySQL that organises content into books, chapters and pages, with search, role permissions, SSO and MFA.- CitadelCitadel is a fully open-source, self-hosted groupware suite that combines email, calendaring, contacts, forums, wikis, blogs, and instant messaging into a single, rooms-based platform. It is designed for both small organizations and large-scale public access systems.
ColanodeOpen-source, local-first chat-and-docs workspace that stands in for Slack and Notion; self-hosted via Docker Compose or Helm with Postgres, Redis and object storage.
0 comments