Professional Programmer for 11 Years. Ron is a DZone MVB and is not an employee of DZone and has posted 8 posts at DZone. You can read more from them at their website. View Full User Profile

How to Setup a Free MediaWiki on Heroku

12.14.2012
| 4130 views |
  • submit to reddit

I had to setup a wiki for some project, and thought of using Heroku for this purpose.

Heroku doesn’t cost anything for 1 dyno, and comes with a bundled 5MB database that might just suffice for this project’s need. To my surprise, I didn’t find any guide on how to do it … but the task didn’t prove to be difficult at all:

  1. Create a new git repository
  2. Populate it with the latest MediaWiki installation
  3. heroku create <app_name>
  4. git push heroku master
  5. Setup a CNAME record pointing wiki.yourproject.org to your-project.herokuapp.com
  6. git config | grep DATABASE
  7. Go to http://wiki.yourproject.org/, follow the wizard and configure your database
  8. This creates a LocalSettings.php file – download it but DO NOT COMMIT IT yet.
  9. Edit it, and replace all the local database settings with this:
## Database settings
$_wgDBConnectionString = getenv('DATABASE_URL');
if (preg_match('%(.*?)://([^:]+):([^@]+)@([^:]+):(\d+)/(.*)%', $_wgDBConnectionString, $regs, PREG_OFFSET_CAPTURE)) {
$wgDBtype = $regs[1][0];
$wgDBuser = $regs[2][0];
$wgDBpassword = $regs[3][0];
$wgDBserver = $regs[4][0];
$wgDBport = $regs[5][0];
$wgDBname = $regs[6][0];
} else {
die("Failed to parse DB connection string");
}

(Obviously, it’s important not to commit your user/pass to a public git repository. If you accidentally did, just remove all reference to it from source control, parse the connection string as above, and then reset your db password).

For your convenience/reference, here is the github repository, although I recommend to just follow the procedure above in order to get the latest MediaWiki and setup wizard.

Published at DZone with permission of Ron Gross, author and DZone MVB. (source)

(Note: Opinions expressed in this article and its replies are the opinions of their respective authors and not those of DZone, Inc.)