wikijs

[](https://github.com/Requarks/wiki/releases) [](https://github.com/requarks/wiki/blob/master/LICENSE) [](#backers) [](#sponsors) [](https://www.npmjs.com/package/wiki.js) [](https://hub.docker.com/r/requarks/wiki/) ![Build Status](https://requarks.visualstudio.com/_apis/public/build/definitions/5850c090-02b9-4312-b4ce-0e1f5677b5/6/badge) [![Codacy Badge](https://img.shields.io/codacy/grade/1d0217a315/master.svg?style=flat)](https://www.codacy.com/app/Requarks/wiki) [](http://standardjs.com/) [](https://gitter.im/Requarks/wiki) [](https://twitter.com/requarks) [](https://waffle.io/Requarks/wiki) ##### A modern, lightweight and powerful wiki app built on NodeJS, Git and Markdown

• Official Website
• Getting Started
• Documentation
• Requirements
• Demo
• Change Log
• Feature Requests
• Milestones
• Chat with us
• Donate
• T-Shirts Shop
• Translations (We need your help!)
• Special Thanks
• Contribute

Requirements

Wiki.js can run on virtually all platforms where Node.js can (Windows, Mac, Linux, etc.).

• Node.js 6.11.1 or later
• MongoDB 3.2 or later
• Git 2.7.4 or later
• An empty Git repository (optional)

Read the full prerequisites article for full details.

Docker / Cloud Install

A docker image is available on Docker Hub.
You can also use a Dockerfile (see example) or Docker Compose (see example) to run Wiki.js.

Deploy to Heroku using this pre-built deployment template:

Deploy to IBM Cloud Foundry using this pre-built deployment template (thanks to @seafre):

Demo

The legacy Wiki.js documentation site is actually running Wiki.js! Check it out »

We do not provide a demo with write access because of potential security / spam issues. The best way to try it is to install it on your own server / computer. It's easy!

Milestones

Current and upcoming milestones (major features only, see the changelog for complete list of features and bug fixes):

:bookmark_tabs: See project board to keep track of current progress.

1.0.78 - Stable

Note: As 2.0 is under development, no new features are being developed in the 1.0 branch.

• Fixed: Missing raven dependency for sentry logging
• Fixed: Azure AD email getter

2.0.0 - Dev

Goals:

• Decouple front-end and back-end completely.
• All operations and queries will be made via GraphQL API.
• New fully responsive layout, with better customization capabilities.
• Full localization support, especially for non-latin languages.
• Modular approach to auth, editors, logging, search and storage.
  

Release Date: Q3 2018

Breaking Changes:

• MongoDB is being phased out in favor of PostgreSQL/MySQL/MSSQL/SQLite + Redis. An upgrade tool will be provided to migrate existing data to the new system.
• Node.js 8.9 LTS or later is now the minimum supported version.

2.0 Milestone:

• GraphQL API
• Migrate to Objection.js + Redis datastore
• Telemetry for analytics and crash reporting (Optional and fully anonymized)
• Docker support + Auto compile/publish to Docker Hub
• Make use of all available CPU cores, distributed jobs queue
• Modular authentication providers (+ new Auth0, Discord and Twitch providers)
• Persist system settings to database instead of file-based
• Shared kernel for both app and setup
• Improved installation wizard
• Modular logging providers
• New Login page
• Two-Factor Authentication (2FA)
• New Navigation Concept
• New Admin Area
  • UI
  • System Info
  • Locales
  • Manage Groups
  • Manage Users
  • Manage Authentication Strategies
  • Manage Storage Targets
• Requarks Graph :octocat:
  • Countries
  • Locales + translations
• Modular editors
  • Markdown editor
  • Core Editor
  • Live Preview
  • Toolbar
  • Operations
  • Create
  • Update
  • Move / Rename :rocket:
  • Delete :rocket:
  • Dialogs
  • Properties
  • Access
  • Image + File Manager
• Modular content parsers/renderers
• Modular search engines
  • DB
  • Azure Search
  • Algolia
• Modular storage engines
  • Git
  • Local Disk :rocket:
• Multilingual versions of the same page (i18n)
• History / Revert to previous version
• User Groups + Better permissions management
• Tags per document / folder

:rocket: = Currently in development

2.1 Milestone

• Comments / Discussion per document
• Profile page per user
• Diagrams as code (Mermaid module)
• Themes
• Additional search engines
  • Elasticsearch
  • Solr
• Additional storage engines
  • Dropbox
  • Google Drive
  • Amazon S3
  • Azure Blob Storage
  • DigitalOcean Spaces
  • Onedrive
  • Owncloud
  • SCP (SSH)
• Modular Editor: TinyMCE (wysiwyg)

TBD Milestone

• Better simultaneous user editing handling
• High Availability support (multiple concurrent instances)

Gitter

Want to discuss features, ideas or issues? Join our gitter channel. We are very active and friendly!

Twitter

Follow our Twitter feed to learn about upcoming updates and new releases!

T-Shirts Shop

Want to donate to this project but get something in return as well? Check out our amazing t-shirts for men, women and kids, as well as other goodies: Wiki.js Shop

Translations

We are looking for translators to make Wiki.js available in multiple languages. If your language is not listed below and would like to contribute to this project, contact us on our gitter channel and we'll provide you with the necessary tool to add translations, no coding required!

Languages that are already translated:

• English
• Chinese - Thanks to @choicky
• Czech - Thanks to @braniqvranik
• Dutch - Thanks to @weirdwater
• Estonian - Thanks to @vonforum
• French
• German - Thanks to @joetjengerdes, @MyZeD
• Greek - Thanks to @ekchatzi
• Italian - Thanks to @CupCakeArmy
• Japanese - Thanks to @johnnyshields, @JO3QMA
• Korean - Thanks to @junwonpk
• Persian - Thanks to @ashkang
• Portuguese - Thanks to @felipeplets
• Russian - Thanks to @efimlosev
• Slovak - Thanks to @braniqvranik
• Spanish - Thanks to @MatiasArriola
• Swedish - Thanks to @pontus-andersson

Special Thanks

Algolia for providing access to their incredible search engine.

Browserstack for providing access to their great cross-browser testing tools.

Cloudflare for providing their great CDN, SSL and advanced networking services.

DigitalOcean for providing hosting of the Wiki.js documentation site.

Contributors

This project exists thanks to all the people who contribute. [Contribute].

Backers

Thank you to all our backers! 🙏 [Become a backer]

Sponsors

Support this project by becoming a sponsor. Your logo will show up here with a link to your website. [Become a sponsor]