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 http://static.moinmo.in/files/moin-1.9.7.tar.gz

    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 http://moinmo.in/MoinMoinDownload.

  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 setup.py install --prefix=$HOME/moinenv --record=install.log
  2. To test the MoinMoin installation, type the following command. The interactive Python console starts:

    python
  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 http://www.example.com/moin-1.9.7/moin.fcgi, where example.com 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 http://www.example.com/moin-1.9.7, instead of http://www.example.com/moin-1.9.7/moin.fcgi.

 

More Information

For more information about MoinMoin, please visit http://moinmo.in.