---
title: "Deploy Wiki.js"
description: "Open-source Wiki.js 3 wiki with PostgreSQL 18, no default password"
category: "CMS"
url: https://railway.com/deploy/wikijs-2
---

# Deploy Wiki.js

Open-source Wiki.js 3 wiki with PostgreSQL 18, no default password

**[Deploy Wiki.js on Railway](https://railway.com/template/wikijs-2)**

Machine-readable deploy manifest (JSON, validated by TemplateCI): https://railway.com/deploy/wikijs-2/manifest.json

- **Creator:** Agaz Self-Host
- **Category:** CMS

## Template content

### Wiki.js https://cdn.jsdelivr.net/gh/homarr-labs/dashboard-icons/png/wikijs.png

- **Source:** https://github.com/aalfath/wiki-js-railway-template
- **Health check:** /_ready
- **Public domain:** Yes

### Postgres https://devicons.railway.app/i/postgresql.svg

- **Image:** ghcr.io/railwayapp-templates/postgres-ssl:18

## Documentation

# Deploy and Host Wiki.js on Railway

Wiki.js is an open-source wiki and knowledge base built on Node.js and PostgreSQL. Version 3 adds collaborative real-time editing, page approvals, discussions, fine-grained group permissions, many sign-in providers (OAuth2, OIDC, SAML, LDAP) and full-text search, all managed from a web administration area.

## About Hosting Wiki.js

Hosting Wiki.js 3 means running its Node.js server next to PostgreSQL 17 or later, which stores pages, users, settings and uploads. This template builds the official Wiki.js 3.4.0 image, pinned by digest, from a public GitHub repo and connects it to Railway PostgreSQL 18 over the private network. A volume keeps Wiki.js's data folder across redeploys, and a health check on `/_ready` holds traffic until database migrations finish. The first administrator is created on the first start from the email you enter and a generated password. Railway provides HTTPS on a public domain, and you can add your own domain later.

## Common Use Cases

* Internal team documentation, runbooks and onboarding guides
* A public knowledge base or product documentation site
* A personal or community wiki with group-based editing rights

## Dependencies for Wiki.js Hosting

* PostgreSQL 17 or later (Railway PostgreSQL 18 is included)
* A persistent volume for the Wiki.js data folder (included)

### Deployment Dependencies

* Wiki.js source and releases: https://github.com/requarks/wiki/releases/tag/3.4.0
* Wiki.js installation docs: https://docs.js.wiki/setup/installation
* Template repo (Dockerfile, changelog): https://github.com/aalfath/wiki-js-railway-template

### Implementation Details

You only enter `ADMIN_EMAIL`. After the deploy, open the Wiki.js service's **Variables** tab to read `ADMIN_PASS`, sign in at your Railway domain with both, then change the password under your profile. `ADMIN_EMAIL` and `ADMIN_PASS` are read only on the first start; later changes to them have no effect.

Mail (SMTP), sign-in providers, storage targets and the site URL are set in Wiki.js under **Administration**. Updates come from the template repo: each merge to its `main` branch shows up as an "update available" notice, and its `CHANGELOG.md` lists what changed.

## Why Deploy Wiki.js on Railway?


Railway is a singular platform to deploy your infrastructure stack. Railway will host your infrastructure so you don't have to deal with configuration, while allowing you to vertically and horizontally scale it.

By deploying Wiki.js on Railway, you are one step closer to supporting a complete full-stack application with minimal burden. Host your servers, databases, AI agents, and more on Railway.



## Similar templates

- [Libredesk - Complete Setup](https://railway.com/deploy/libredesk-complete-setup) — Complete self-hosted omnichannel customer support desk.
- [Paperless-ngx](https://railway.com/deploy/paperless-ngx-3) — Paperless-ngx — document management with OCR and full-text search
- [Instatic CMS - Postgres](https://railway.com/deploy/instatic-cms-postgres) — Design, build and manage powerful static sites from state-of-the-art CMS

Open this page in a browser: https://railway.com/deploy/wikijs-2
