MediaWiki

Contents

Install pre-requisites
Install MediaWiki
1. Start your MediaWiki
2. Start Mediawiki from a remote location
Customize
Email Support
Extensions
Install skins in MediaWiki
MediaWiki TurnKey appliance
Other Resources

MediaWiki is the engine that is used for Wikipedia. See MediaWiki for more information.

Beware: apt-get installs old versions of mediawiki, which is no longer supported by upstream.

Install pre-requisites

The easiest method is to first install a full LAMP (Linux, Apache2, MySQL, PHP) server:

sudo apt-get install tasksel

sudo tasksel install lamp-server

Make sure you record your MySQL root superuser name and superuser password that you will create at installation. You will need it later.

(Each of the components (Apache2, MySQL5, and PHP) can also be installed individually, if you wish.)

Install MediaWiki

Install the package:

sudo apt-get install mediawiki

Optionally install add-ons:

sudo apt-get install imagemagick mediawiki-math php5-gd

Enable MediaWiki by editing the following file and remove the '#' from the third line so that it reads 'Alias /mediawiki /var/lib/mediawiki':

sudo nano /etc/mediawiki/apache.conf

Apparently in Ubuntu 14.04 and above you might have to further enable it by running
```
  sudo a2enconf mediawiki
```
but this hasn't been verified yet. It is possible that the above line might be needed in earlier versions of Ubuntu too, but again this hasn't been confirmed.

Then restart apache:

sudo /etc/init.d/apache2 restart

Start your MediaWiki

http://localhost/mediawiki

Follow the setup instructions.

Start Mediawiki from a remote location

This method regards starting your website from a remote location. Since you will be entering passwords, you shouldn't use an unsecured connection. Either set up a ssl server] (see OpenSSL) and connect with https://yoursite.example.com/mediawiki, or visit from the server itself (using elinks or lynx, two excellent text-based web browsers):

elinks localhost/mediawiki

You could also use ssh to port forward your http traffic from your local machine to the remote server. ssh -C -L 9999:localhost:80 regularuser@www.skippybob.com, edit your /etc/hosts to point the webserver's name to your localhost, then open a web browser to the config page: http://wiki.skippybob.com:9999/config. More detailed instructions here.

fill out the forms, noting that the final form is NOT your root or user password, but the password for the root mysql account (blank by default)

Lastly, move the config files as requested to prevent anyone else from changing these settings:

NOTE: Check the output in your web browser: if its instructions differ from below, follow them.

sudo cp /var/lib/mediawiki/config/LocalSettings.php /etc/mediawiki/LocalSettings.php
sudo chown www-data /etc/mediawiki/LocalSettings.php
sudo chmod 600 /etc/mediawiki/LocalSettings.php
sudo rm -Rf /var/lib/mediawiki/config

You are done! you should see a wiki page at: http://yoursite.example.com/mediawiki

Customize

You might want to customize the look of your wiki.

To change the icon make a 135x135 pixel logo in PNG format and move it to the right place:

sudo cp my_new_logo.png /var/lib/mediawiki/skins/common/images/my_new_logo.png

Avoid to use the same name as the original logo (wiki.png), it will be overwritten when upgrading Mediawiki.

Insert the path to the image at the end of configuration file in /etc/mediawiki/LocalSettings.php like so:

 $wgLogo = "/mediawiki/skins/common/images/my_new_logo.png" ;

To get rid of the default sunburst logo in the background, edit /var/lib/mediawiki/skins/monobook/main.css and change:

background: #f9f9f9 url(headbg.jpg) 0 0 no-repeat;

background: #f9f9f9;

Email Support

MediaWiki can be configured to send email messages for various functions. You will need to install some additional packages:

sudo apt-get install php-pear
sudo pear install mail
sudo pear install Net_SMTP

Also, you'll need to configure the LocalSettings.php file to use your SMTP server to send out the messages, for example:

$wgEnableEmail      = true;
$wgEnableUserEmail  = true;
$wgEmergencyContact = "wikidude@mydomain.com";
$wgPasswordSender = "wikidude@mydomain.com";
$wgNoReplyAddress = "noreply@mydomain.com";
$wgPasswordSender = "password_reminder@mydomain.com";

$wgSMTP = array(
 'host'     => "ssl://smtp.gmail.com",
 'IDhost'   => "gmail.com",
 'port'     => 465,
 'auth'     => true,
 'username' => "user_name@mydomain.com",
 'password' => "user_password"
);

Extensions

Mediawiki extensions are stored as symbolic links in the /etc/mediawiki-extensions/extensions-available folder. You can enable an extension using

sudo mwenext <extension.php>

Tab/autocomplete shows a list of extensions.

Similarly use mwdisext to disable an extension.

Install skins in MediaWiki

Download a skin tarball (such as example.tar.gz) and extract.
Create a directory, e.g. /var/lib/mediawiki/skins/example
Move the extracted content into the directory /var/lib/mediawiki/skins/example.
In /var/lib/mediawiki/skins put exemple.php and exemple.deps.php.
Go to http://localhost/mediawiki/ -> Preference -> Aspects and choose the example skin.

MediaWiki TurnKey appliance

Some users may prefer an unofficial pre-integrated TurnKey MediaWiki Appliance based on Ubuntu LTS.

Ubuntu Documentation