Manual:Installing MediaWiki on SourceForge.net

Introduction

edit
Some instructions are no longer required with the new project web system rolled out by SourceForge.net. See this for more. This document has been updated for this.

These are the instructions for manually installing MediaWiki on SourceForge.net. SourceForge, however, now supports MediaWiki as a hosted app. To install, you can just go to Project Admin -> Feature Settings, click the Available Features tab, and then check "MediaWiki". The hosted app doesn't have much flexibility (it doesn't allow you to change skins or add extensions), although it does integrate with the SourceForge user accounts.

Let's say that:

  • your project is named "myproject"
  • your login on sourceforge is "username"

Installation

edit

Database creation

edit

Log in on sourceforge, go to "Project Admin" > "Feature Settings", then "Configure" side "MySQL Database". You must set the passwords.

For example :

  • m12345ro:passworddb
  • m12345rw:passworddb
  • m12345admin:passworddb

Create the database m12345_wikidb on https://mysql-m.sourceforge.net/ (https://mysql-[your project character].sourceforge.net/)

Copy mediawiki on your site

edit

Copy content of your MediaWiki folder to sftp://username,myproject@web.sourceforge.net/home/project-web/myproject/htdocs/wiki

Configure mediawiki

edit

Go to http://myproject.sourceforge.net/wiki/

   * Wiki name: MyProject
   * Contact e-mail: username@users.sourceforge.net
   * Admin username: WikiSysop
   * Password : mypassword
   * Shared memory caching: CACHE_ACCEL
   * E-mail (general): enabled
   * mysql: mysql-m
   * Database name: m12345_wikidb
   * DB username : m12345admin
   * DB password: passworddb 

Remove config folder

Memory

edit

Start LocalSettings.php with

<?php
# If PHP's memory limit is very low, some operations may fail.
ini_set( 'memory_limit', '32M' );

SourceForge requires that you ask their permission before you use this setting [1]

E-mail

edit

To enable email, set up an email password by going to "Project Settings -> Features", clicking on "Manage" beside "Project Web" and setting it from there. After that, add to LocalSettings.php:

$wgSMTP = array(
 'host'     => "prwebmail", //could also be an IP address
 'IDHost'   => "YOUR_PROJECT_NAME_HERE",
 'port'     => 25,
 'auth'     => true,
 'username' => "YOUR_PROJECT_NAME_HERE",
 'password' => "YOUR_PROJECT_EMAIL_PASS_HERE"
);

Email should now work, but SourceForge will monitor abuse of the service. As such, it is recommended to disable the send out of watchlist emails or install Extension:ConfirmEdit.

Optional configuration

edit
edit

Add these lines to LocalSettings.php:

	$wgFooterIcons['poweredby']['sourceforge'] = array(
        "src" => "http://sflogo.sourceforge.net/sflogo.php?group_id=353187&amp;type=1",
        "url" => "http://sourceforge.net/projects/myproject",
        "alt" => "Get myproject at SourceForge.net. Fast, secure and Free Open Source software downloads",
);

Enabling upload

edit

You then need to change a setting in LocalSettings.php to enable upload:

$wgEnableUploads = true;

Block anonymous IP-addresses

edit

Using a Short URL

edit

In order to use short URLs, you will need to follow the directions at Manual:Short URL/wiki/Page title -- no root access. Note that these directions assume that you installed the wiki in the "w" directory and want "wiki" to be a part of the short URL.

Dealing with slow performance

edit

If you suffer from (very) slow performance, have a look at Manual:Performance tuning.