--- title: "Deploy MediaWiki" description: "The wiki software behind Wikipedia, on the official image with MySQL" category: "CMS" url: https://railway.com/deploy/mediawiki-1 --- # Deploy MediaWiki The wiki software behind Wikipedia, on the official image with MySQL **[Deploy MediaWiki on Railway](https://railway.com/template/mediawiki-1)** Machine-readable deploy manifest (JSON, validated by TemplateCI): https://railway.com/deploy/mediawiki-1/manifest.json - **Creator:** Agaz Self-Host - **Category:** CMS ## Template content ### MySQL - **Image:** mysql:8.4.13@sha256:a81d043930e51745522bd5c430961cf8286f0a23f0a9a2a6e0108f7ea71b0902 - **Start command:** `/bin/sh -c "rm -rf /var/lib/mysql/lost+found && exec docker-entrypoint.sh mysqld --innodb-use-native-aio=0 --disable-log-bin --performance_schema=0 --innodb-buffer-pool-size=256M"` ### MediaWiki https://cdn.jsdelivr.net/gh/homarr-labs/dashboard-icons/svg/mediawiki.svg - **Image:** mediawiki:1.46.2@sha256:406a08c7f2cf5a9c9cb590bbe27a21b4d3cb3268b0acf327fa7dd2727ff6b0be - **Start command:** `/bin/sh -c "echo IyEvYmluL3NoCiMgTWVkaWFXaWtpIG9uIFJhaWx3YXk6IGZpcnN0LXN0YXJ0IGluc3RhbGwsIHVwZ3JhZGUgb24gYm9vdCwgQXBhY2hlIG9uICRQT1JULgpzZXQgLWV1CldFQj0vdmFyL3d3dy9odG1sCkRBVEE9JHtSQUlMV0FZX1ZPTFVNRV9NT1VOVF9QQVRIOi0vZGF0YX0KUE9SVD0ke1BPUlQ6LTgwfQpEQl9IT1NUPSR7TVdfREJfSE9TVDo/TVdfREJfSE9TVCBpcyBub3Qgc2V0fQpEQl9QT1JUPSR7TVdfREJfUE9SVDotMzMwNn0KREJfTkFNRT0ke01XX0RCX05BTUU6LW1lZGlhd2lraX0KREJfVVNFUj0ke01XX0RCX1VTRVI6LXJvb3R9CjogIiR7TVdfREJfUEFTU1dPUkQ6P01XX0RCX1BBU1NXT1JEIGlzIG5vdCBzZXR9IgpleHBvcnQgTVdfREJfSE9TVCBNV19EQl9QT1JUPSIkREJfUE9SVCIgTVdfREJfTkFNRT0iJERCX05BTUUiIE1XX0RCX1VTRVI9IiREQl9VU0VSIgppZiBbIC16ICIke01XX1NFUlZFUjotfSIgXTsgdGhlbgogIGlmIFsgLW4gIiR7UkFJTFdBWV9QVUJMSUNfRE9NQUlOOi19IiBdOyB0aGVuIE1XX1NFUlZFUj0iaHR0cHM6Ly8kUkFJTFdBWV9QVUJMSUNfRE9NQUlOIjsgZWxzZSBNV19TRVJWRVI9Imh0dHA6Ly9sb2NhbGhvc3Q6JFBPUlQiOyBmaQpmaQpleHBvcnQgTVdfU0VSVkVSCgojIFVwbG9hZHMgYW5kIExvY2FsU2V0dGluZ3MucGhwIGxpdmUgb24gdGhlIHZvbHVtZS4KbWtkaXIgLXAgIiREQVRBL2ltYWdlcyIKaWYgWyAhIC1MICIkV0VCL2ltYWdlcyIgXTsgdGhlbgogIGNwIC1hbiAiJFdFQi9pbWFnZXMvLiIgIiREQVRBL2ltYWdlcy8iIDI+L2Rldi9udWxsIHx8IHRydWUKICBybSAtcmYgIiRXRUIvaW1hZ2VzIgogIGxuIC1zICIkREFUQS9pbWFnZXMiICIkV0VCL2ltYWdlcyIKZmkKZmluZCAiJERBVEEvaW1hZ2VzIiAhIC11c2VyIHd3dy1kYXRhIC1leGVjIGNob3duIHd3dy1kYXRhOnd3dy1kYXRhIHt9ICsgMj4vZGV2L251bGwgfHwgdHJ1ZQpybSAtcmYgIiREQVRBL2xvc3QrZm91bmQiIDI+L2Rldi9udWxsIHx8IHRydWUKCiMgQXBhY2hlIGxpc3RlbnMgb24gUmFpbHdheSdzIFBPUlQuCiMgbW9kX3BocCBuZWVkcyB0aGUgcHJlZm9yayBNUE07IGRyb3AgYW55IG90aGVyIE1QTSBsaW5rIFJhaWx3YXkncyBpbWFnZSB1bnBhY2tpbmcgbGVhdmVzIGJlaGluZC4KZm9yIGYgaW4gL2V0Yy9hcGFjaGUyL21vZHMtZW5hYmxlZC9tcG1fKi5sb2FkOyBkbwogIGNhc2UgIiRmIiBpbiAqL21wbV9wcmVmb3JrLmxvYWQpIDs7ICopIHJtIC1mICIkZiIgIiR7ZiUubG9hZH0uY29uZiIgOzsgZXNhYwpkb25lClsgLWUgL2V0Yy9hcGFjaGUyL21vZHMtZW5hYmxlZC9tcG1fcHJlZm9yay5sb2FkIF0gfHwgYTJlbm1vZCAtcSBtcG1fcHJlZm9yawpzZWQgLXJpICJzL15MaXN0ZW4gWzAtOV0rJC9MaXN0ZW4gJFBPUlQvIiAvZXRjL2FwYWNoZTIvcG9ydHMuY29uZgpzZWQgLXJpICJzLzxWaXJ0dWFsSG9zdCBcKjpbMC05XSs+LzxWaXJ0dWFsSG9zdCAqOiRQT1JUPi8iIC9ldGMvYXBhY2hlMi9zaXRlcy1lbmFibGVkLzAwMC1kZWZhdWx0LmNvbmYKCiMgU2V0dGluZ3MgYXBwbGllZCBvbiBldmVyeSBzdGFydCAocmVhZCBmcm9tIHZhcmlhYmxlcyBhdCByZXF1ZXN0IHRpbWUpLgpta2RpciAtcCAvZXRjL21lZGlhd2lraQpjYXQgPiAvZXRjL21lZGlhd2lraS9SYWlsd2F5U2V0dGluZ3MucGhwIDw8J1BIUCcKPD9waHAKLy8gV3JpdHRlbiBieSB0aGUgUmFpbHdheSB0ZW1wbGF0ZSBhdCBlYWNoIHN0YXJ0LiBDaGFuZ2UgYmVoYXZpb3VyIHdpdGggc2VydmljZSB2YXJpYWJsZXMuCiR3Z1NlcnZlciA9IGdldGVudiggJ01XX1NFUlZFUicgKSA/OiAkd2dTZXJ2ZXI7CiR3Z0Nhbm9uaWNhbFNlcnZlciA9ICR3Z1NlcnZlcjsKJHdnREJzZXJ2ZXIgPSBnZXRlbnYoICdNV19EQl9IT1NUJyApIC4gJzonIC4gKCBnZXRlbnYoICdNV19EQl9QT1JUJyApID86ICczMzA2JyApOwokd2dEQnVzZXIgPSBnZXRlbnYoICdNV19EQl9VU0VSJyApID86ICdyb290JzsKJHdnREJwYXNzd29yZCA9IGdldGVudiggJ01XX0RCX1BBU1NXT1JEJyApOwokd2dFbmFibGVVcGxvYWRzID0gdHJ1ZTsKJHdnVXBsb2FkRGlyZWN0b3J5ID0gIiRJUC9pbWFnZXMiOwovLyBDbG9zZWQgYnkgZGVmYXVsdDogb25seSBsb2dnZWQtaW4gdXNlcnMgZWRpdCwgb25seSBhZG1pbnMgY3JlYXRlIGFjY291bnRzLgokd2dHcm91cFBlcm1pc3Npb25zWycqJ11bJ2VkaXQnXSA9IGdldGVudiggJ01XX0FOT05fRURJVCcgKSA9PT0gJ3RydWUnOwokd2dHcm91cFBlcm1pc3Npb25zWycqJ11bJ2NyZWF0ZXBhZ2UnXSA9IGdldGVudiggJ01XX0FOT05fRURJVCcgKSA9PT0gJ3RydWUnOwokd2dHcm91cFBlcm1pc3Npb25zWycqJ11bJ2NyZWF0ZXRhbGsnXSA9IGdldGVudiggJ01XX0FOT05fRURJVCcgKSA9PT0gJ3RydWUnOwokd2dHcm91cFBlcm1pc3Npb25zWycqJ11bJ2NyZWF0ZWFjY291bnQnXSA9IGdldGVudiggJ01XX09QRU5fU0lHTlVQJyApID09PSAndHJ1ZSc7CmlmICggZ2V0ZW52KCAnTVdfUFJJVkFURV9XSUtJJyApID09PSAndHJ1ZScgKSB7Cgkkd2dHcm91cFBlcm1pc3Npb25zWycqJ11bJ3JlYWQnXSA9IGZhbHNlOwp9ClBIUAoKd2FpdF9mb3JfZGIoKSB7CiAgaT0wCiAgdW50aWwgcGhwIC1yICdteXNxbGlfcmVwb3J0KE1ZU1FMSV9SRVBPUlRfT0ZGKTsgJG0gPSBAbXlzcWxpX2Nvbm5lY3QoZ2V0ZW52KCJNV19EQl9IT1NUIiksIGdldGVudigiTVdfREJfVVNFUiIpLCBnZXRlbnYoIk1XX0RCX1BBU1NXT1JEIiksICIiLCAoaW50KWdldGVudigiTVdfREJfUE9SVCIpKTsgZXhpdCgkbSA/IDAgOiAxKTsnOyBkbwogICAgaT0kKChpICsgMSkpCiAgICBpZiBbICIkaSIgLWdlIDkwIF07IHRoZW4gZWNobyAiTXlTUUwgYXQgJE1XX0RCX0hPU1Q6JE1XX0RCX1BPUlQgaXMgbm90IHJlYWNoYWJsZSIgPiYyOyBleGl0IDE7IGZpCiAgICBlY2hvICJXYWl0aW5nIGZvciBNeVNRTCAoJGkpLi4uIgogICAgc2xlZXAgMgogIGRvbmUKfQp3YWl0X2Zvcl9kYgoKY2QgIiRXRUIiCmlmIFsgISAtZiAiJERBVEEvTG9jYWxTZXR0aW5ncy5waHAiIF07IHRoZW4KICA6ICIke01XX0FETUlOX1BBU1NXT1JEOj9NV19BRE1JTl9QQVNTV09SRCBpcyBub3Qgc2V0fSIKICBlY2hvICJGaXJzdCBzdGFydDogaW5zdGFsbGluZyBNZWRpYVdpa2kiCiAgcm0gLWYgIiRXRUIvTG9jYWxTZXR0aW5ncy5waHAiCiAgcGhwIG1haW50ZW5hbmNlL3J1bi5waHAgaW5zdGFsbCBcCiAgICAtLWRidHlwZT1teXNxbCAtLWRic2VydmVyPSIkREJfSE9TVDokREJfUE9SVCIgLS1kYm5hbWU9IiREQl9OQU1FIiBcCiAgICAtLWRidXNlcj0iJERCX1VTRVIiIC0tZGJwYXNzPSIkTVdfREJfUEFTU1dPUkQiIFwKICAgIC0tc2VydmVyPSIkTVdfU0VSVkVSIiAtLXNjcmlwdHBhdGg9IiIgLS1sYW5nPSIke01XX0xBTkc6LWVufSIgXAogICAgLS1wYXNzPSIkTVdfQURNSU5fUEFTU1dPUkQiIC0td2l0aC1leHRlbnNpb25zIC0tc2tpbnM9VmVjdG9yLE1vbm9Cb29rLFRpbWVsZXNzLE1pbmVydmFOZXVlIFwKICAgIC0tY29uZnBhdGg9L3RtcCBcCiAgICAiJHtNV19TSVRFX05BTUU6LU15IFdpa2l9IiAiJHtNV19BRE1JTl9VU0VSOi1BZG1pbn0iCiAgcHJpbnRmICdcbiMgUmFpbHdheSB0ZW1wbGF0ZSBvdmVycmlkZXMgKGRvIG5vdCByZW1vdmUpXG5yZXF1aXJlX29uY2UgIi9ldGMvbWVkaWF3aWtpL1JhaWx3YXlTZXR0aW5ncy5waHAiO1xuJyA+PiAvdG1wL0xvY2FsU2V0dGluZ3MucGhwCiAgbXYgL3RtcC9Mb2NhbFNldHRpbmdzLnBocCAiJERBVEEvTG9jYWxTZXR0aW5ncy5waHAiCmZpCmNob3duIHd3dy1kYXRhOnd3dy1kYXRhICIkREFUQS9Mb2NhbFNldHRpbmdzLnBocCIKY2htb2QgNjQwICIkREFUQS9Mb2NhbFNldHRpbmdzLnBocCIKIyBBIHN0dWIgaW4gdGhlIHdlYiByb290IGxvYWRzIHRoZSByZWFsIHNldHRpbmdzIGZyb20gdGhlIHZvbHVtZSAoYSBzeW1saW5rIGlzIG5vdCByZWFkYWJsZSBieSBQSFAgaGVyZSkuCnJtIC1mICIkV0VCL0xvY2FsU2V0dGluZ3MucGhwIgpwcmludGYgJzw/cGhwXG5yZXF1aXJlX29uY2UgIiVzL0xvY2FsU2V0dGluZ3MucGhwIjtcbicgIiREQVRBIiA+ICIkV0VCL0xvY2FsU2V0dGluZ3MucGhwIgoKIyBIZWFsdGggY2hlY2sgZm9yIFJhaWx3YXk6IDUwMyB1bnRpbCB0aGUgd2lraSBpcyBjb25maWd1cmVkIGFuZCBNeVNRTCBhbnN3ZXJzLgpta2RpciAtcCAiJFdFQi9oZWFsdGh6IgpjYXQgPiAiJFdFQi9oZWFsdGh6L2luZGV4LnBocCIgPDwnUEhQJwo8P3BocApteXNxbGlfcmVwb3J0KCBNWVNRTElfUkVQT1JUX09GRiApOwokb2sgPSBpc19yZWFkYWJsZSggZGlybmFtZSggX19ESVJfXyApIC4gJy9Mb2NhbFNldHRpbmdzLnBocCcgKQoJJiYgQG15c3FsaV9jb25uZWN0KCBnZXRlbnYoICdNV19EQl9IT1NUJyApLCBnZXRlbnYoICdNV19EQl9VU0VSJyApLCBnZXRlbnYoICdNV19EQl9QQVNTV09SRCcgKSwgZ2V0ZW52KCAnTVdfREJfTkFNRScgKSwgKGludClnZXRlbnYoICdNV19EQl9QT1JUJyApICk7Cmh0dHBfcmVzcG9uc2VfY29kZSggJG9rID8gMjAwIDogNTAzICk7CmhlYWRlciggJ0NvbnRlbnQtVHlwZTogdGV4dC9wbGFpbicgKTsKZWNobyAkb2sgPyAib2tcbiIgOiAibm90IHJlYWR5XG4iOwpQSFAKCmVjaG8gIlJ1bm5pbmcgZGF0YWJhc2UgdXBkYXRlcyIKcGhwIG1haW50ZW5hbmNlL3J1bi5waHAgdXBkYXRlIC0tcXVpY2sKCmV4ZWMgYXBhY2hlMi1mb3JlZ3JvdW5kCg== | base64 -d > /tmp/railway-start.sh && exec sh /tmp/railway-start.sh"` - **Health check:** /healthz/ - **Public domain:** Yes ## Documentation # Deploy and Host MediaWiki on Railway MediaWiki is the free, open-source wiki software that runs Wikipedia. It stores pages in a database, keeps the full revision history of every edit, and supports templates, categories, file uploads, search and thousands of extensions. Teams use it to build documentation sites, knowledge bases and community wikis. ## About Hosting MediaWiki Hosting MediaWiki needs a PHP web server, a MySQL or MariaDB database, and persistent storage for uploads and the `LocalSettings.php` configuration file. Normally you run a web installer, download the generated `LocalSettings.php` and copy it to the server. This template does that for you. At first start it runs `maintenance/install.php` with all bundled extensions, creates an `Admin` user with a generated password, and keeps settings and uploads on a volume. Every later start runs the database updater, so moving to a newer image migrates the schema. `$wgServer` follows the Railway domain. ## Common Use Cases * Internal documentation and team knowledge base * Public or community wiki for a product, game or project * Private notes wiki with page history and file attachments ## Dependencies for MediaWiki Hosting * MediaWiki 1.46.2 (official `mediawiki` Docker image, Apache + PHP 8.3) * MySQL 8.4 LTS ### Deployment Dependencies * MediaWiki Docker image: https://hub.docker.com/_/mediawiki * MediaWiki 1.46 release notes: https://www.mediawiki.org/wiki/Release_notes/1.46 * Command-line installer: https://www.mediawiki.org/wiki/Manual:Install.php * Start script source: https://github.com/aalfath/mediawiki-railway-template ### Implementation Details **First login:** open the Railway domain and log in as `Admin`. The password is the `MW_ADMIN_PASSWORD` variable on the MediaWiki service. Change it under Preferences. The variable is only read on the first start. **Safe by default:** anonymous visitors can read but not edit, and only admins can create accounts (Special:CreateAccount). To change that, set these variables on the MediaWiki service and redeploy: * `MW_ANON_EDIT=true` lets logged-out visitors edit pages * `MW_OPEN_SIGNUP=true` lets anyone create an account * `MW_PRIVATE_WIKI=true` hides all pages from logged-out visitors **Other optional variables:** `MW_SITE_NAME` (default `My Wiki`), `MW_ADMIN_USER` (default `Admin`) and `MW_LANG` (default `en`) apply to the first start only. If you add a custom domain, set `MW_SERVER=https://wiki.example.com`. **Storage:** `LocalSettings.php` (it holds the wiki's secret key) and all uploads live on the MediaWiki volume at `/data`, and pages live in MySQL. Back up both. Email isn't configured, so password-reset mails aren't sent until you add `$wgSMTP` settings to `/data/LocalSettings.php` (for example over `railway ssh`). ## Why Deploy MediaWiki 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 MediaWiki 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/mediawiki-1