Index

Requirements

Before you install MoinMoin, make sure you have the necessary infra-structure in place, namely the Apache for Microsoft Windows webserver, and a Python installation (version 2.0 or higher is recommended, don't run 1.5.2 without a compelling reason).

In the following description, we assume that you have installed or will install things to these locations:

• C:\Apache - the webserver

• C:\Python - the Python interpreter

• C:\Moin - MoinMoin itself

Quite often, you might want to install things elsewhere, which is no problem at all; you just have to adapt any paths that appear in a command or config file to the locations you have chosen.

This installation procedure was tested with Apache 1.3.23 for Windows running on Windows/NT4SP6a, and using Python 2.0.

Preparation

Installing Apache

You currently need an external webserver to run MoinMoin, the recommended option is to use Apache if you haven't installed one on your machine already. To install Apache, consult the Using Apache With Microsoft Windows document. Make sure that your webserver runs without problems before you start to install MoinMoin; problems with your webserver installation are not in the scope of this document.

Installing Python

Download Python 2.1.2 and install it. Python installation is done via a standard Windows installer program, which you should be familiar with.

Installing MoinMoin

Before creating a wiki instance, you have to download and install the basic MoinMoin software. We assume you already have downloaded the distribution archive to the "C:\TEMP" directory¹.

Open a console window and enter the following commands:

C:
cd \temp
unzip moin-0.11.zip
cd moin-0.11
python setup.py install --prefix=C:\Moin --record=install.log

This will install all necessary files to the "C:\Moin" directory, and create a "install.log" file listing all the files that are created there.

Creating a Wiki Instance

You could run your wiki directly using the sample wiki created in "C:\Moin", but this is not recommended for two reasons:

1. updating your wiki is more complicated and more dangerous.
2. creating a second wiki instance, even if you currently don't plan for one, is much easier.

So, enter these commands in a console window:

cd \Moin
md mywiki
md mywiki\data
xcopy share\moin\data mywiki\data /E
copy share\moin\cgi-bin mywiki

"mywiki" is the name of your wiki instance, you might want to chose a different name best fitting the intended use of this instance; just don't name it simply "wiki", because that would result in problems later on.

Next, start your editor and create the file "C:\Moin\mywiki\moin.bat" with the following content (remember to change any paths that are different with your setup):

@echo off
set PYTHONPATH=C:\Moin
C:
cd \Moin\mywiki
C:\Python\python.exe moin.cgi

• Python 2.2: Python 2.2 changed the installation layout to better fit the UNIX scheme. Because of this, you have to change the command setting the PYTHONPATH to "set PYTHONPATH=C:\Moin\Lib\site-packages".

Then, append these lines to "C:\Apache\conf\httpd.conf":

Alias /wiki/ "C:/Moin/share/moin/htdocs/"
ScriptAlias /mywiki "C:/Moin/mywiki/moin.bat"

The first line you only need once; the second line is needed once for each wiki instance (of course, each one with another wiki name and path).

That is all, restart your Apache server and try to access your new-born wiki with the URL "http://127.0.0.1/mywiki/". You should see the FrontPage, try to edit and save it, and if that works, see if your edit is reflected on the RecentChanges page.

Finally, edit "moin_config.py" and at least change "sitename" and "logo_url" to some personal values:

sitename = 'My Wiki'
logo_url = '/images/mywiki-logo.gif'

For a personal or intranet installation, you'll normally also add the line

allowed_actions = ['DeletePage', 'AttachFile']