mrkeyoor.com_
Mon 21 Sept 13:44 UTC
Self-Hostedevaluationupdated 21 Sept 2026

wiki review

Wiki.js is a self-hosted knowledge base for teams that want their documentation, access rules, and data on infrastructure they control. It combines Markdown and visual editing with page history, authentication options, search, and storage connections in one web application.

Verdict

Our Wiki.js build passed in 74 seconds, but its test command stopped after 12 seconds with 122 lint errors, so source contributors inherit cleanup before they see a green check. Use it when you need a full self-hosted wiki with flexible editing, permissions, and integration modules, and you are ready to standardize on PostgreSQL. Pick a smaller static-docs tool when browser editing and user management would only add operational work.

We ran it

Lab card: what happened when we ran wikiScreenshot of wiki (js.wiki)
Install✓ · 237s2276 packages · 1924 MB
Build✓ · 74s
Tests✗ · 12sran, no count parsed
Repo848 files~52,287 lines of source · 14.3 MB · 3 CI workflows

Answers from our run

Does wiki build from source?

Dependencies installed in 237 seconds (2276 packages), and the build succeeded in 74 seconds. We cloned commit 1161ddc into a clean Debian container with 3 CPUs and no project-specific setup.

Do wiki's tests pass?

The test command failed in our container, and its output did not report a pass or fail count.

Who should not use wiki?

Teams committed to MySQL, MariaDB, MS SQL Server, or SQLite for the long term: the requirements page says those databases will not be supported in the next major version.

What are the alternatives to wiki?

BookStack, Docmost, MkDocs. Our Wiki.

Setup3/5Build passed, but install used 1,924 MB and tests failed
Docs4/5Deployment and database limits are stated plainly
Community4/5Fresh release and push, with a 139-PR backlog
Maturity4/5Active v2 line, with v3 parity work still open

Who it’s for

Engineering teams that need an internal wiki with group permissions and company login providers.
Documentation teams whose writers switch between Markdown and a visual editor.
Operators comfortable running Node.js or Docker beside PostgreSQL on a dedicated domain.
Organizations that want page history and storage backups without buying a hosted knowledge base.

Who it’s NOT for

Teams committed to MySQL, MariaDB, MS SQL Server, or SQLite for the long term: the requirements page says those databases will not be supported in the next major version.
Source contributors who require a green check before starting work: our Node 22 run stopped with 122 errors and 1 warning.
Kubernetes operators using the Helm chart with an SSL-secured external PostgreSQL database: open issue 7942 reports a CA handling bug that leaves the pod in CrashLoopBackOff.
Organizations whose software policy excludes AGPL-3.0 applications: that is the repository's license.
Sites that must mount the wiki under a URL subfolder: the requirements say Wiki.js needs a dedicated domain or subdomain.

Setup reality

Our sandbox install succeeded in 237 seconds, adding 2,276 packages and using 1,924 MB. The build passed in 74 seconds. The test command failed after 12 seconds with 122 errors and 1 warning. Its log said 14 errors and 1 warning might be fixable automatically. The checkout contained 848 files, about 52,287 source lines, and 3 CI workflows, with no Dockerfile or tests directory.

Running Wiki.js needs Node.js 22 or 24, or the published Docker image, plus an empty database and its credentials. PostgreSQL is the recommended choice, and its search module needs pg_trgm. The core setup needs no hosted API secret, while optional authentication, search, and storage services bring their own credentials.

Wiki.js needs a dedicated domain or subdomain and cannot run from a URL subfolder. A reverse proxy is optional for more involved DNS or network setups. SQLite is discouraged for production, and MySQL, MariaDB, MS SQL Server, and SQLite are absent from the stated 3.x database path.

Wiki.js v2.5.315 is a database-backed knowledge base

Wiki.js v2.5.315 gives a team browser editing, page history, group permissions, authentication modules, and several ways to search or copy content into outside storage. Writers can use Markdown or a visual editor, while administrators can connect company login systems and set page rules. That breadth makes sense for an internal handbook or support wiki where readers, editors, and administrators need different access. A folder of Markdown with a theme serves a much smaller job.

The size of our checkout matches that product scope. We counted 848 files and about 52,287 lines of source in 14.3 MB before installing anything. The application spans a Vue interface and a Node.js server, with background work for rendering and indexing. Wiki.js also has a GraphQL interface in the current v2 line. Buyers have to operate, upgrade, back up, and secure the application. A static compiler would stop at publishing files.

PostgreSQL is the database choice that survives the next major version

The requirements page supports PostgreSQL 9.5 or later and recommends using a current release. PostgreSQL search also needs the pg_trgm extension. MySQL, MariaDB, MS SQL Server, and SQLite still work with v2, but the same page says all 4 will lose support in the next major version. A new deployment should therefore begin on PostgreSQL unless its owner accepts a later migration. SQLite is explicitly discouraged for production.

Database setup is only one part of the runtime. Wiki.js expects an empty database with a dedicated user and password, plus a dedicated domain or subdomain. It cannot be mounted under a URL subfolder. Node.js 22 and 24 are supported, while the published Docker image includes Node for you. Our source install still pulled 2,276 packages and occupied 1,924 MB, so building locally is much heavier than starting from the packaged image.

What happened when we ran it

Our sandbox installed Wiki.js in 237 seconds, adding 2,276 packages and using 1,924 MB on disk. The production build then completed successfully in 74 seconds. We ran commit 1161ddc in an unprivileged Debian container with 3 CPUs, 8 GB of RAM, Node 22, and no secrets. Those figures cover repository setup and compilation. We did not use them to claim page speed, search throughput, or concurrent-user capacity.

The test command failed with exit code 1 after 12 seconds. Its final output reported 122 errors and 1 warning, with 14 errors and 1 warning potentially fixable by the linter's fix option. The visible failure pointed to WIKI.logger.warn(err) and did not identify a missing system package or runtime service. The log supports one narrow conclusion: this checkout did not complete its test command cleanly in our stated environment.

The package script runs ESLint, Pug lint, and Jest in sequence. Because ESLint exited first, our result says nothing about how many Jest cases would pass. The repository scan found 3 CI workflow files, no Dockerfile, and no tests directory. The last finding describes the directory layout. Tests can still live elsewhere. The failed top-level command matters more for a contributor deciding whether the branch is ready to change.

The current release fixes 2 advisories while v3 stays in beta

Version v2.5.315 was published on September 21, 2026, the same day GitHub recorded the latest push. Its notes list fixes for 2 security advisories, including commit 1161ddc from our run. Operators should update from an older v2 build instead of treating age as a reason to freeze it. The release activity shows maintenance on the stable line, and the security content gives that maintenance an immediate operational purpose.

Version 3 has a public feature-parity issue that was opened in 2023 and updated on September 18, 2026. The maintainer says the beta will continue until v2 features are implemented, and recommends staying on v2 when a needed feature is absent. The checklist still marks new-page templates as unimplemented and rendering as partial. It also replaces the v2 GraphQL development interface with REST and narrows search to PostgreSQL, so migration deserves feature-by-feature testing.

139 open pull requests temper an active release cadence

GitHub showed 28,949 stars, 41 open issues, and 139 open pull requests when we fetched the project on September 21, 2026. A release and repository push landed that day, while the v3 parity issue had changed 3 days earlier. Wiki.js is plainly active. The 139-PR queue is still large enough that a prospective contributor should inspect review times and maintainer response on changes similar to the one they intend to submit.

Open issue 7942 gives operators a specific deployment check. It reports that Helm chart v3.0.0 passes an external PostgreSQL CA as a file path while Wiki.js expects base64 certificate content, causing a CrashLoopBackOff with certificate verification enabled. The report was still open after an August 9, 2026 update. Teams using that chart shape should reproduce SSL database startup before committing a migration window. Disabling certificate checks is not a sound acceptance test.

Wiki.js earns its footprint when you need the whole application

A clean source install that ends at 1,924 MB is difficult to justify for a small public manual maintained through pull requests. MkDocs fits that case with static output and no application database. BookStack offers a more prescribed book-and-chapter model, while Docmost focuses on collaborative workspaces. Wiki.js is the better fit when one deployment must cover browser editing, granular access, login integrations, page history, and storage copies.

The 28,949-star count tells you the audience is large. Your operating needs should decide. A team already running PostgreSQL and a reverse proxy can absorb Wiki.js more easily, and the 74-second build proves the measured commit compiles in a clean Node 22 container. Contributors still face the 122 lint errors that stopped our test command. Trial the editors and permissions with real users, test the v3 parity list against your modules, and keep the database on the supported upgrade path.

Alternatives

ProjectWhat it isPick it when
BookStackA PHP and Laravel wiki organized around books, chapters, and pages.pick this instead when a fixed book-and-chapter structure suits your team and PHP is already standard infrastructure.
Docmost gh↗A collaborative team wiki centered on live editing and shared workspaces.pick this instead when simultaneous editing matters more than Wiki.js's wider module catalog.
MkDocsA Markdown documentation generator that publishes static files.pick this instead when docs belong in Git and you do not need accounts, a database, or browser editing.

What people are saying

  1. [velocity-scout] requarks/wiki
  2. [lobsters] OSRS Wiki and RuneLite are increasingly under strain from low-effort AI development
  3. [velocity-scout] OI-wiki/OI-wiki
  4. [techcrunch-ai] OpenAI confirms ‘wiki incident,’ says it’s ‘working on a framework’ for more disclosure
  5. [theverge] OpenAI admits to German wiki ‘incident’
  6. [arstechnica] OpenAI agents discussed ways to escape their sandbox on public wiki

Sources

  1. Wiki.js repository and README
  2. Wiki.js features
  3. Wiki.js server requirements
  4. Wiki.js v2.5.315 release
  5. Wiki.js v3 feature parity checklist
  6. Helm external PostgreSQL SSL issue

More self-hosted reviews

dashy · animeko · server · iptv · Bubble-Card · ace-step-ui · the whole board →