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) ##### 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
• 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.

Cloud Install

Docker Cloud, Azure, IBM Bluemix and more coming soon!

Docker

A docker Wiki.js image is available on Docker Hub:

You can also use a Dockerfile (see example) or Docker Compose (see example) to run Wiki.js.

Demo

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):

1.0.68 - Stable

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

• Added generic OAuth2 authentication provider

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.
  

Release Date: Q1 2018

Breaking Changes:

• MongoDB is being phased out in favor of PostgreSQL + 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 PostgreSQL + Redis datastore
• Telemetry for analytics and crash reporting (Optional and fully anonymized)
• Docker support + Auto compile/publish to Docker Hub
• Support sub-directory installations (e.g. example.com/wiki)
• Make use of all available CPU cores, distributed jobs queue
• Modular authentication providers (+ new Auth0, Discord and Twitch providers)
• Shared kernel for both app and setup
• Improved installation wizard
• Modular logging providers
• New Login page
• Two-Factor Authentication (2FA)
• New Navigation Concept
• Themes :rocket:
• Modular editors :rocket:
  • SimpleMDE (markdown)
  • Monaco (code)
• Modular content parsers/renderers :rocket:
• Modular search engines
  • PostgreSQL search engine
• Modular storage engines :rocket:
  • Git
  • Local Disk
• Multilingual versions of the same page (i18n)
• History / Revert to previous version
• Persist system settings to database instead of file-based
• User Groups + Better permissions management
• Tags per document / folder

:rocket: = Currently in development

2.1 Milestone

• Comments / Discussion per document
• Profile page per user
• Preview changes directly from the editor, without saving
• Diagrams as code (Mermaid module)
• Insert Link modal in Markdown Editor
• Additional storage engines
  • Dropbox
  • Google Drive
  • Amazon S3
  • Azure Blob Storage
  • Onedrive
  • Owncloud
• 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!

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

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

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]