Knowledge Base

How to install MoinMoin on a shared hosting account

This article describes how to install the Python-based MoinMoin wiki engine on a shared hosting account.

Installing MoinMoin

To install the MoinMoin wiki engine, you first create a virtual environment for Python by using the virtualenv tool. After you activate the virtual environment, you can download and install the MoinMoin archive. To do this, follow these steps:

  1. Log in to your account using SSH.
  2. To create and activate the virtual environment, type the following commands:
    cd ~
    virtualenv moinenv
    source moinenv/bin/activate

    These commands create a virtual environment named moinenv, and subsequent commands in this article assume that the environment is named moinenv. If you use a different environment name, make sure you replace all occurrences of moinenv with your own environment name.

  3. To download MoinMoin, type the following commands:

    cd ~/public_html
    curl -O

    The previous command downloads MoinMoin version 1.9.7, which was the most recent version when this article was written. To download a different version, please visit

  4. To extract the MoinMoin files from the archive, type the following command:

    tar xvfz moin-1.9.7.tar.gz
  5. The MoinMoin files are now located in the /home/username/public_html/moin-1.9.7 directory, where username represents your account username.

Configuring MoinMoin

You have downloaded and extracted the MoinMoin files. Now you can configure and test the installation:

  1. Type the following commands to set up the MoinMoin installation:
    cd ~/public_html/moin-1.9.7
    python install --prefix=$HOME/moinenv --record=install.log
  2. To test the MoinMoin installation, type the following command. The interactive Python console starts:

  3. At the >>> Python prompt, type the following command:

    import MoinMoin

    You should not receive any error messages. If you receive an ImportError message, then MoinMoin did not install correctly. Confirm that you ran the command in step 1 above with the correct path specified for the —prefix option.

  4. Press Ctrl-D to exit the interactive Python console.

  5. Type the following commands to copy the MoinMoin FastCGI file and create a symbolic link to the static web files:

    cp -fv ~/public_html/moin-1.9.7/wiki/server/moin.fcgi ~/public_html/moin-1.9.7/
    ln -s ~/moinenv/lib/python2.6/site-packages/MoinMoin/web/static/htdocs/ ~/public_html/moin_static197

    If you update the MoinMoin installation to a new version, you must also create a new symbolic link that references the correct version number.

  6. Use your browser to go to, where represents your domain name. You should see the MoinMoin Welcome page.

    To access MoinMoin using a more convenient URL, copy the following lines into an .htaccess file in the moin-1.9.7 directory:

    RewriteEngine On
    RewriteRule   ^(moin\.fcgi.*)$  - [L]
    RewriteRule   ^(.*)$  moin.fcgi/$1 [L]

    With these changes, you can access MoinMoin using the shorter URL, instead of


More Information

For more information about MoinMoin, please visit