selfhost.directory

The index of self-hostable projects — ranked, categorized and served with live updates.
Own your data and stop giving it to big tech.

Wiki.js logo

Self-host Wiki.js

3.4.0

Open-source wiki engine with markdown and two-way Git sync

BetaOpen SourceAGPL-3.0
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
Updatedyesterday
LanguageTypescript
Setup difficultyEasy
Stars
29 301
RAM
1GB
Port
3000 (HTTP / WebSocket port the wiki app listens on)
Requires
ltree / pg_trgm PostgreSQL extensions, PostgreSQL
Docker
ghcr.io/requarks/wiki

What is 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

Wiki.js

GitHub Release License GitHub Sponsors Open Collective backers and sponsors
Chat on Discord Follow on Bluesky Follow on Telegram Reddit

Next Generation Open Source Wiki

Donate

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.

Become a Sponsor Become a Patron Donate on OpenCollective Donate via Paypal Buy a T-Shirt

Gold Tier Sponsors

GitHub Sponsors

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)

Special Thanks

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.

How to install Wiki.js

Install Wiki.js with Docker

Environment variables
ADMIN_EMAIL, ADMIN_PASS, CONFIG_FILE, DATABASE_URL, DB_HOST, DB_NAME, DB_PASS, DB_PASS_FILE, DB_PORT, DB_SCHEMA, DB_SSL, DB_SSL_CA, LOG_FORMAT, LOG_LEVEL, PORT
# -----------------------------
# BETA VERSION
# -----------------------------
ghcr.io/requarks/wiki:3.0.0-beta
# or using a specific version:
ghcr.io/requarks/wiki:3.0.0-beta.660

Assuming you have a PostgreSQL container named db on the same network (replace the values with your own!):

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

Once the container is started, browse to http://YOUR-IP-ADDRESS:8080 and login using the admin email and password you provided in the command above.

Official multi-arch images (linux/amd64, linux/arm64). Beta tags only: use 3.0.0-beta, never the latest tag. The docs example passes ADMIN_EMAIL, whose value is shown email-obfuscated on the page — set it to your own admin address.

How to configure Wiki.js

  • port3000The port to listen on.
  • db.hostlocalhostHostname or IP address of the PostgreSQL database.
  • db.port5432Port of the PostgreSQL database.
  • db.userpostgresUsername to connect to the PostgreSQL database.
  • db.passpostgresPassword to connect to the PostgreSQL database

Wiki.js releases & version history

@ Every self-hosted release, weekly

One Monday email with the week's stable releases across the directory.

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

Rate this project

Click to rate — no account needed.

0 comments

Posting as guest
Loading comments…