Deploy XWiki
Open-source enterprise wiki: XWiki 18.9 with PostgreSQL, no setup wizard
Just deployed
/usr/local/xwiki
Just deployed
/var/lib/postgresql/data
Deploy and Host XWiki on Railway
XWiki is an open-source enterprise wiki and application platform, written in Java. Teams use it to write structured documentation and knowledge bases, with page history, fine-grained access rights, full-text search, and an extension manager that adds blogs, forums, diagrams, task lists and custom applications.
About Hosting XWiki
XWiki runs as a Java web application in Tomcat and needs a relational database, a persistent directory for attachments, extensions and its search index, and about 1 GB of Java heap. On a new install, someone must create the first administrator and install the default flavor (the standard pages and applications) through XWiki's Distribution Wizard, and until then any visitor can reach that wizard. This template does both steps on the first start, with XWiki listening on localhost only, while a placeholder page answers on the public URL. That first start takes about 15 minutes. Later starts take a minute or two.
Common Use Cases
- Internal company wiki and knowledge base with per-space access rights
- Product, engineering and support documentation with page history and search
- Lightweight structured apps (forms, lists, dashboards) built with XWiki's App Within Minutes
Dependencies for XWiki Hosting
- PostgreSQL (Railway's PostgreSQL service, included)
- A volume for XWiki's permanent directory
/usr/local/xwiki(included)
Deployment Dependencies
- XWiki 18.9.0 from the official Docker image
xwiki:18.9.0-postgres-tomcat, pinned by digest in aalfath/xwiki-railway-template - XWiki installation guide and release notes
Implementation Details
- No setup wizard exposed: the first start creates the administrator
XWIKI_ADMIN_USER(defaultAdmin) with the generatedXWIKI_ADMIN_PASSWORD, then installs the standard XWiki flavor. Both run before XWiki opens on the public port. Find the password in the XWiki service's Variables tab, log in, and change it from your profile if you like. - Persistence: pages, users and history live in PostgreSQL. Attachments, installed extensions and the Solr search index live on the volume.
- Optional settings: set
JAVA_OPTS(for example-Xmx2g) on a bigger plan. Mail (SMTP) for registration and notifications is set in XWiki under Administer Wiki → Mail. Guests can view and register by default; change that under Administer Wiki → Users & Rights. - Updates: the XWiki service builds from the GitHub repo, so Railway shows an update notice when the pinned XWiki version changes. After you apply one, log in as an administrator and follow the Distribution Wizard to upgrade the flavor.
Why Deploy XWiki 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 XWiki 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.
Template Content