Website review
This review may include AI-generated content and is not individually verified. Domain, certificate and other facts come from the observed data on this page.
What is Wiki.js?
Wiki.js is an open-source wiki and documentation platform released under the AGPL-v3 license, per its official site Wiki.js. It is aimed at teams that want to write and organize documentation in a self-hosted system rather than a hosted SaaS product, and it is built on Node.js with a focus on performance.
Its main selling point is flexibility. You can run it on platforms ranging from a Raspberry Pi to a cloud VM, and it supports PostgreSQL, MySQL, MariaDB, MS SQL Server, or SQLite as the database. Content can be public, fully private, or a mix. Administrators manage everything through a built-in admin area, and the appearance, including light and dark mode, is customizable.
Who it suits
- Developer teams that prefer Markdown with live preview, toolbar shortcuts, and version tracking of every content change.
- Non-technical contributors who need a WYSIWYG visual builder instead of syntax.
- Organizations with existing identity systems, since authentication can use local accounts, social providers (Google, Facebook, Microsoft, GitHub, Discord, Slack), or enterprise options such as LDAP, SAML, CAS, Auth0, Okta, and Azure AD, with generic OAuth2/OpenID Connect and 2FA support.
- Teams migrating from MediaWiki, though the WikiText editor for that is listed as coming soon.
Trade-offs to weigh
Self-hosting gives you control over data and access, but you take on installation, upgrades, and server maintenance. The modular design—authentication, editors, search, storage, themes, and more can be toggled on or off—means you can keep the setup lean, but it also means you must decide which modules you actually need. The site advertises over 50 integrations, which is useful if your workflow depends on external services, yet it is not a reason by itself to choose the platform.
A practical next step: if your team already writes in Markdown and wants private documentation with SSO, install Wiki.js on a small VM or Raspberry Pi using SQLite first, test the editor and authentication modules, then scale the database and hosting once the workflow fits.
How do I install Wiki.js on my server?
Wiki.js is self-hosted software, so "installing" it means running the application on hardware you control and pointing it at a supported database. The official page describes it as installable "anywhere," with compatibility for PostgreSQL, MySQL, MariaDB, MS SQL Server, or SQLite, and says step-by-step guides exist for all platforms. The practical decision is less about the install command and more about where it runs and which database backs it.
Choose your installation shape
| Approach | Best for | Trade-off |
|---|---|---|
| Node.js directly on a VM or server | Full control, existing server infrastructure | You manage Node, the database, process supervision, and updates yourself |
| Docker / container | Most small teams and quick trials | Adds a container runtime dependency; persistent storage and database need separate handling |
| Small device (e.g. Raspberry Pi) | Personal wikis, home labs, learning | Resource limits appear as content and integrations grow |
The page explicitly mentions scaling from a Raspberry Pi to a high-performance cloud VM, so a single install path can follow you from a test box to production.
The database choice matters most
- SQLite — simplest to start because it is file-based, but it is the least suited to concurrent editing and heavier traffic.
- PostgreSQL or MySQL/MariaDB — the sensible default for a team wiki; both are widely hosted and well documented.
- MS SQL Server — pick this only if it is already your organization's standard.
Decide this before you install, since migrating later is more work than choosing correctly up front.
What to prepare
- A server with a supported OS and enough RAM for Node.js plus your database.
- A database instance and credentials, or a plan to use SQLite for a trial.
- A domain name and TLS certificate if the wiki will be reachable outside your network.
- A decision on visibility: the page notes a wiki can be public, completely private, or a mix, so plan authentication before you invite users.
After the install
The first meaningful configuration is authentication. Wiki.js bundles local accounts with self-registration and password recovery, supports social logins such as Google, GitHub, and Slack, and integrates with enterprise systems including LDAP, SAML, Azure AD, and Okta, plus generic OAuth2/OpenID Connect and 2FA on supported modules. For a company wiki, wiring in your existing identity provider early avoids a later migration of user accounts.
Then trim the feature set. The page stresses that modules can be turned on or off on demand, covering authentication, editors, history, localization, media assets, rendering, search, storage, user management, and themes. A small team can leave most of this at defaults; a larger deployment should decide deliberately about search, storage, and rendering, because those affect performance and where files live.
A concrete first step
If you are evaluating rather than committing, stand up a throwaway instance on a spare machine or VM with SQLite, confirm that the editor and admin area fit your team's workflow, then rebuild on PostgreSQL or MySQL before you put real content in it. If you want to compare the project's positioning and current install documentation, start at Wiki.js.
Which databases and platforms does Wiki.js support?
Wiki.js supports several database backends and runs on virtually any platform that can host Node.js. According to the project page, it is compatible with PostgreSQL, MySQL, MariaDB, MS SQL Server and SQLite, and it is described as working on almost any platform, from a Raspberry Pi to a high-performance cloud VM.
H3 Database options
| Database | Typical fit |
|---|---|
| PostgreSQL | Teams wanting a robust, feature-rich default for larger wikis |
| MySQL / MariaDB | Organizations already standardized on these databases |
| MS SQL Server | Windows-centric or Microsoft-heavy environments |
| SQLite | Small teams, testing, or low-traffic personal wikis |
The practical trade-off is between simplicity and scale. SQLite is the easiest to set up because it is file-based and needs no separate database server, which suits a personal wiki or a small pilot. PostgreSQL, MySQL, MariaDB and MS SQL Server are better when multiple editors, larger content volumes or existing database administration and backup practices matter.
H3 Platform and deployment notes
Because Wiki.js runs on Node.js, it is not tied to one operating system. The page states it works on virtually any platform and offers step-by-step install guides. It also says the software intelligently uses available resources, so the same installation can run on a Raspberry Pi or a cloud VM.
For a concrete decision: if you are a solo user or testing the software, start with SQLite on a small machine. If you are deploying for a team and already run PostgreSQL or MySQL, use that database so your existing backups, monitoring and access controls apply.
Next step: check the official installation guides at Wiki.js to match your operating system and chosen database before installing.
How can I customize the appearance and permissions of my Wiki.js wiki?
Customizing Wiki.js splits into two independent jobs: themes control how the wiki looks, while permissions and authentication control who sees and edits what. The page evidence notes that Wiki.js is "fully customizable" for appearance, including light and dark mode, and that it can be made "public, completely private or a mix of both" — so you can tune the two separately.
Appearance
- Themes module — the admin area exposes a Themes module that can be turned on or off on demand, alongside modules for Editors, Rendering, Media Assets, Localization, Search, Storage and User Management. The bundled themes give you light/dark modes without writing CSS.
- Custom CSS and branding — for a logo, colour palette or typography that matches your organisation, expect to supply custom CSS or template overrides rather than relying on a settings toggle. That is general advice for a self-hosted wiki, not a documented Wiki.js feature.
- Editors affect the writing experience, not the look — Markdown, a visual WYSIWYG builder and plain HTML are separate editor modules. If non-technical colleagues will write pages, enabling the visual builder matters more than any colour change.
Permissions
- User Management module — controls accounts and self-registration. Built-in local authentication supports self-registration and password recovery.
- Authentication modules — choose social sign-in (Google, GitHub, Microsoft and others), enterprise identity (LDAP, SAML, CAS, Auth0, Okta, Azure AD) or generic OAuth2/OpenID Connect. Two-factor authentication can be layered on supported modules.
- Public, private or mixed — the visibility model is the key decision. A private internal handbook for staff, a public product manual, or a hybrid where some namespaces are open and others are restricted are all supported.
A practical scenario
A ten-person team running an internal handbook on a small server might enable local authentication, turn on 2FA for admins, enable the visual builder for non-developers and the Markdown editor for engineers, then keep the whole wiki private. A company publishing public API docs would instead enable social login for contributors, leave the reference pages public, and restrict draft namespaces to staff.
How to decide
| Goal | What to change |
|---|---|
| Match corporate branding | Theme settings plus custom CSS/templates |
| Let non-coders write pages | Enable the visual builder editor module |
| Restrict sensitive sections | Authentication and User Management modules; use mixed visibility |
| Reduce risk of account takeover | Enable 2FA on supported authentication modules |
Next step: open the admin area, confirm which modules are currently enabled, and change one thing at a time — switch the theme first, then adjust visibility, then authentication. If you want to compare approaches with another open-source wiki, look at DokuWiki or MediaWiki.
What authentication methods and integrations does Wiki.js offer?
Wiki.js supports three broad authentication paths: built-in local accounts, social sign-in, and enterprise identity providers. You can mix them, and add two-factor authentication on top of supported modules.
Authentication options
- Local authentication: built-in accounts with self-registration and password recovery.
- Social login: third-party services including Google, Facebook, Microsoft, GitHub, Discord, and Slack.
- Enterprise: LDAP, SAML, CAS, Auth0, Okta, and Azure AD, plus generic OAuth2 and OpenID Connect modules.
- 2FA: available for supported authentication modules.
Integrations and extensibility
Wiki.js ships with modules you can switch on or off, covering authentication, editors, history, localization, media assets, rendering, search, storage, user management, and themes. The site advertises 50+ integrations in total.
Editors as a related integration choice
| Editor | Best for |
|---|---|
| Markdown | Developers who want live preview and shortcuts |
| Visual Builder | Non-technical writers who need WYSIWYG |
| Plain HTML | Importing preformatted HTML from elsewhere |
| WikiText, API Docs, Tabular | Listed as coming soon |
Practical takeaway
If your team already uses Google Workspace or GitHub, start with social authentication for speed. If you have an existing directory, go straight to LDAP, SAML, or OIDC so you avoid maintaining a second set of credentials. Then enable 2FA where the module supports it.
A useful next step: list your identity sources, check each against the modules above, and decide whether you need one editor type or several before installing. See Wiki.js for the current module list.
Is Wiki.js free or does it require a paid subscription?
Wiki.js is free and open source. It is released under the AGPL-v3 license, so you can install and run it without paying a subscription fee. The project does mention a "Subscribe" link, but that is for following project updates rather than a required paid plan.
The practical cost of Wiki.js is not a license fee but the infrastructure and effort to run it. You need somewhere to host it and a supported database such as PostgreSQL, MySQL, MariaDB, MS SQL Server or SQLite.
H3 Who this suits
- Small teams and individuals who want a self-hosted documentation site without recurring software fees.
- Organizations with existing infrastructure, because Wiki.js can use authentication systems like LDAP, SAML, CAS, Auth0, Okta or Azure AD.
- Teams with mixed technical skills, since it offers Markdown for developers and a visual WYSIWYG editor for non-technical contributors.
H3 Trade-offs to consider
- You are responsible for hosting, backups, updates and security.
- The AGPL-v3 license matters if you plan to modify and redistribute the software.
- Some features, such as WikiText, API Docs and Tabular editors, are still marked as coming soon.
If you are comparing options, decide based on who will maintain the server. A hosted wiki service may cost money but removes maintenance; Wiki.js keeps the software free while leaving operations to you. You can review the project at Wiki.js.
User reviews (0)