Documentation

Setting up MediaWiki

This page will go through a basic setup of MediaWiki. It is based on the official MediaWiki installation wikipage, and it gives a few specifics for setting it up on a hosted account over at ULYSSIS.

This tutorial we'll use a ULYSSIS-account with username "me".

Putting setup-files in place

First we'll have to download the setup file which you can find over at the official MediaWiki website.

It's an archived file, so you need to extract it first and put the files in a subdirectory of your "document root". The default is just a www directory in your home folder.

Putting your files in document_root/wiki/ will make your wiki be located at usersname.ulyssis.be/wiki/.

If you prefer, you can do this all graphically using the manual Accessing_your_files.

If you prefer the command line;

homeuser@home:~$ ssh me@ssh1.ulyssis.org
enter super secret password:
me@zap:~$ wget http://releases.wikimedia.org/mediawiki/1.23/mediawiki-1.23.6.tar.gz
me@zap:~$ tar xvxf mediawiki-1.23.6.tar.gz
me@zap:~$ mv mediawiki-1.23.6 www/wiki
me@zap:~$ rm -r mediawiki-1.23.6.tar.gz

Setting up database

Like the the official MediaWiki installation wiki tells us, we have three different options to choose from; PostgreSQL, MySQL and SQLite.

It's easy to set a PostgreSQL or MySQL database; just go to the UCC. For this tutorial we will continue with a MySQL database (PostgreSQL installation steps are quite similar).

Let us visit https://ucc.ulyssis.org/mysql; if this is your first time using MySQL you'll need to create a new account by putting in a super secret password. The wizard will create your MySQL account with the same name as your user-account. We'll also create a new database with an appropriate name by clicking on 'Add database'. In this tutorial we will choose; "wiki", notice that it will be prepended with our username, so we'll end up with a new database named "me_wiki".

Setup your wiki

If all went well, you can access your website at http://username.ulyssis.be/the_folder_you_used and start the setup wizard. In our example, will surf to http://me.ulyssis.be/wiki.

The wizard will guide you through some configuration options. Most of them our pretty straight-forward. When in doubt, you can always click the question mark wich will show you some sensible and recommended default... We'll just discuss the page were the wizard asks you for the database. In our example;

Database host: mysql.ulyssis.org
Database name: me_wiki
// The name of our database; i.e. the name we chose, prepended by our username.
Database table prefix:
// We can leave this blank.
Database user: me
// This is the name of our MySQL-user, which was named after our ULLYSIS-username.
Database password: supersecretpassword
// Please note that this is not your ULLYSIS-password, but the password you used in UCC when creating the MySQL user!

Creating the wiki

After the setup wizard is complete, you can begin the installation procedure. If all went well, you'll be greeted by a page which congratulates you with your new installation.

Finalizing steps

The setup will offer you a configuration file (containing some settings you specified) that you need to download to your server (more specifically in directory where your MediaWiki-files reside in).

You again can do this graphically, or if you prefer a terminal;

homeuser@home:~$ scp path_to_file/LocalSettings.php me@ssh1.ulyssis.org:~/www/wiki
enter super secret password:

After this is done, you can finally start using your wiki.

!!! Note that this is only a very basic case of a wiki install. Please refer to the original MediaWiki wiki for a more in depth source. !!!

!!! Please know that managing a wiki comes with great responsibility, keep your wiki up to date and follow healthy and recommended security practices. !!!