Linux: Detailed Quick Installation

Download MoinMoin

Please read the MoinMoinDownload wiki page to find and download the latest MoinMoin release version.

Please remember the path where you saved that download and also its exact filename.

The filename will likely be something like moin-1.9.0.tar.gz (for moin version 1.9.0), but we will just talk of moin-x.x.x because the concrete version number changes often. You have to use the real version number in the commands you enter, not x.x.x, of course.

Working on the shell

For the next steps, we will work on a shell prompt (for sure you can also do all the steps using some GUI tool of your favourite desktop environment, but because of the diversity of those environments, you will have to find out the right tools yourself using these steps as a guideline).

If you use some graphical desktop environment or some X Window Manager, you will first have to find a terminal window (usually called "Terminal", "XTerm", "shell", "bash", "Command line window" or similar) and start it. If you see something showing a $ and a blinking cursor to the right of it, it worked. We shall also refer to this window as the "shell".

Note that you must not use a "root shell" for this type of installation. Just use a shell as the non-priviledged user you usually log in as. You can use the id command to display what user you are and it must not display "root".

For the next steps, we assume you have downloaded the moin archive into your home directory and that the current directory is your home directory (that's the default when you start a shell, usually indicated by a shell prompt showing ~$ - the tilde means you are in your home directory and the dollar means that you can enter a command to the right of it).

Verify the integrity of your downloaded file

Make sure the archive downloaded correctly by verifying the md5sum (a checksum) of the archive:

$ md5sum moin-x.x.x.tar.gz
XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX  moin-x.x.x.tar.gz

The value (XXX...) md5sum shown left of the filename must match the value published on the download page for the file you just downloaded!

If it does not match, your download is corrupted somehow. Remove the file and try downloading it again.

Unpack MoinMoin

We use a gzipped tar archive for our release archives - you need to unpack it before using.

Unpack it using this command on the shell:

$ tar xvzf moin-x.x.x.tar.gz
(it will show a long list of all files it has unpacked)

This will create a directory moin-x.x.x in the current directory with all the MoinMoin release files in it.

Run MoinMoin

MoinMoin is written using the Python programming language so you need to start it using the python interpreter:

$ cd moin-x.x.x
$ python wikiserver.py
(you will see the log output of the running MoinMoin server here)

After MoinMoin has started, it will show some log output in your terminal window. Within that logging output, it will also announce on which IP address and port the server runs (e.g. http://127.0.0.1:8080).

Now just leave that terminal window as it is and the builtin web server of MoinMoin will work as long as you don't stop it.

You can stop the server by closing that terminal window or by pressing Ctrl-C to interrupt it.

Use MoinMoin

Just point your web browser at the address you got from the terminal window (e.g.: http://127.0.0.1:8080/ or http://localhost:8080/ ).

You should now see your fresh moin wiki in your browser. Maybe bookmark that address so you don't have to enter it manually each time you want to use your wiki.

Your wiki is now ready to use. Have fun!

Mac: Detailed Quick Installation

Apple's Mac operating system comes with Python already installed as a part of the core system software making running a MoinMoin wiki very easy.

Download MoinMoin

1. Download the latest Moin from MoinMoinDownload page.

2. Double-click to expand.

Starting Moin for the first time

By default, python scripts (.py) will open in TextEdit.app. For convenience, we'll want to associate .py files to open in Terminal.app so that we can simply double-click the wikiserver.py file to run Moin.

1. Right-click (control-click) on the wikiserver.py file.

2. From the contextual-menu,

   1. Select "Open with..." > "Other...";

   2. From the file dialog, select "All Applications", check "Always Open With", then navigate to Terminal.app (located in //Applications/Utilites/).
      (The "Always open with" sets Terminal.app as the default application so in future you can double-click the wikiserver.py file).

Daily Use

1. Double-click on the wikiserver.py file and Terminal.app will launch.

2. Point your browser at http://localhost:8080

3. To quit the wiki, simply close the terminal window.

Windows: Detailed Quick Installation

MoinMoin relies on Python which requires a separate install on Windows.

Download & Install Python

• Go to http://www.python.org/download/ and download the Python installer.

• Run the installer!
  • If you want to save some space, you can unselect all but the first two options (you won't need the 'Test Suite', 'Utility Scripts', or 'Documentation' unless you plan to develop in Python).
  • The installer will automatically associate .py files with Python.

Download & Expand MoinMoin

1. Download the latest MoinMoin from the MoinMoinDownload page.

2. Extract the files to a folder (using a utility such as 7-zip or similar).

3. Simply double-click wikiserver.py which you will find in this folder.

Daily Use

1. Double-click on the wikiserver.py file and a black command window will open.

2. Point your browser to http://localhost:8080/.

3. To quit the wiki, simply close the command window.