Software install inside an individual hosting account

This article provides step by step instructions specific to the installation of MoinMoin in a shared web hosting account where you may not always have the same levels of access or environment control as you would on your own server or a dedicated hosting environment.

Download the latest version from http://moinmo.in/MoinMoinDownload (verify the checksum!)
uncompress and untar

Install:

python setup.py install --home=$HOME
cp -a ~/share/moin/htdocs ~/public_html/wiki

Edit your shell profile to add something like:

PYTHONPATH=$HOME/lib/python:$PYTHONPATH
export PYTHONPATH

Web server config

Setup vhost as per normal

Add the following fragment inside the <VirtualHost *> section:

        <IfModule mod_rewrite.c>
        RewriteEngine On

        RewriteRule ^/wiki/       -                      [L]
        RewriteRule ^/error/      -                      [L]
        RewriteRule ^/robots.txt  -                      [L]
        RewriteRule ^/favicon.ico /home/USERNAME/public_html/wiki/favicon.ico       [L]

        # SUBPATH is optional
        RewriteRule ^/SUBPATH/?(.*) /home/USERNAME/public_html/cgi-bin/moin.cgi/$1 [L,type=application/x-httpd-cgi]
        </IfModule>

Wiki config

It is best to leave WHATEVER as used below as a valid python module name, so better use only lower letters "a-z" and "_". Do not use blanks or "-"

Copy the wiki data:

mkdir -p -m 0700 ~/data/moin
cp -a ~/share/moin/data ~/data/moin/WHATEVER

Copy the default wiki config:

mkdir -p -m 0700 ~/etc/moin/
cp -a ~/share/moin/config/* ~/etc/moin/
cd ~/etc/moin/wikifarm
cp mywiki.py WHATEVER.py

vi WHATEVER.py
```
data_dir = 'HOME/data/moin/WHATEVER'
```
vi farmconfig.py
- Ensure that the wikis array has a line something like:
```
    ("WHATEVER", r".*/SUBPATH/?.*"),
```
- Set the paths for:
```
data_underlay_dir = 'HOME/share/moin/underlay'
url_prefix_static = '/wiki' # Or wherever you copied the htdocs in the software install step
```
- See HelpOnConfiguration within your wiki (or http://moinmo.in/HelpOnConfiguration) for configuration details. Things you probably want to configure:
  - Mail settings so that you can send out updates
  - show_hosts possibly
  - Disable anonymous edits if desired by setting:
```
acl_rights_default  = u'All:read'
```

Copy the CGI handler:

cp ~/share/moin/server/moin.cgi ~/cgi-bin
chmod 700 ~/cgi-bin/moin.cgi

vim ~/cgi-bin/moin.cgi
- Fix up the paths:
```
sys.path.insert(0, 'HOME/etc/moin')
sys.path.insert(0, 'HOME/lib/python')
sys.path.insert(0, 'HOME/etc/moin/wikifarm')
```
- You may need to change the interpreter to be a newer version of python (at least 2.3)