This blog has moved to Medium

Subscribe via email


How to setup a free MediaWiki on Heroku

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.

2 Comments

  1. חן אגוזי:

    This is good, but not great.

    Compare to that:

    http://blogs.msdn.com/b/interoperability/archive/2012/10/02/new-open-source-options-for-windows-azure-web-sites-mediawiki-and-phpbb.aspx

    I love Heroku, and I have got a lot of criticism toward Microsoft, but you can safely say that they did nail this one (and similar scenarios as well)

  2. ripper234:

    90 day free trial? Heroku (basic) is free forever.
    I could also clone an AMI and host it at AWS free for a year if I wanted to.