Wiki.js — Modern Open Source Wiki Platform

What it is

Wiki.js is an open-source wiki platform built on Node.js that provides both Markdown and WYSIWYG editors for creating and managing documentation. It synchronizes content with Git repositories, supports full-text search powered by PostgreSQL or Elasticsearch, and handles multi-language content natively.

It targets engineering teams, documentation writers, and organizations that need a self-hosted knowledge base with modern editing tools. Wiki.js works well as an internal documentation hub, a public-facing knowledge base, or a team wiki.

How it saves time or tokens

Wiki.js reduces documentation overhead by providing Git-based version control for all content. Every edit is tracked, diffable, and reversible. The Git sync feature means teams can write documentation in their preferred text editor, push to a repository, and have Wiki.js render it automatically.

Full-text search eliminates the time spent navigating folder hierarchies. PostgreSQL-powered search indexes all content and returns results ranked by relevance, which is faster than scanning through file trees or grepping repositories.

How to use

1. Deploy Wiki.js using Docker. Pull the official image and connect it to a PostgreSQL database. The application runs on port 3000 by default.
2. Complete the setup wizard in the browser, configure authentication (local, LDAP, OAuth, SAML), and set the default editor (Markdown or WYSIWYG).
3. Create pages, organize them into folders, enable Git sync for backup or bidirectional editing, and configure search indexing.

Example

# Deploy Wiki.js with Docker Compose
version: '3'
services:
  wikijs:
    image: ghcr.io/requarks/wiki:2
    environment:
      DB_TYPE: postgres
      DB_HOST: db
      DB_PORT: 5432
      DB_USER: wikijs
      DB_PASS: wikijsrocks
      DB_NAME: wiki
    ports:
      - '3000:3000'
    depends_on:
      - db
  db:
    image: postgres:15
    environment:
      POSTGRES_DB: wiki
      POSTGRES_USER: wikijs
      POSTGRES_PASSWORD: wikijsrocks

Related on TokRepo

• AI tools for documentation — More documentation and knowledge management tools
• AI tools for self-hosted — Self-hosted alternatives for your infrastructure

Common pitfalls

• Choosing SQLite for production deployments. Wiki.js works with SQLite for testing but full-text search performance degrades significantly with larger content volumes. Use PostgreSQL for any serious deployment.
• Enabling Git sync without understanding the conflict resolution model. If two users edit the same page simultaneously through different interfaces (web UI and Git push), the last write wins, which can silently overwrite changes.
• Not configuring a search engine beyond the default. PostgreSQL built-in search works for most teams, but organizations with thousands of pages should evaluate Elasticsearch for faster and more flexible querying.