HelpOnConfiguration/IntegratingWithApache

Standalone or Twisted setup

If you want to use Twisted, edit mointwisted.py and set these options:

    port = 8000
    interfaces = ['localhost']

If you want to use Standalone, edit standalone.py and set these options:

    port = 8000
    interface = 'localhost'

Now run your moin server and check that it works at http://localhost:8000.

Apache 2 setup

This setup requires mod_proxy and mod_headers. Make sure they are installed and loaded before you continue.

Edit your Apache configuration file, either httpd.conf or an included configuration file:

# Can be off for reverse proxying, more secure
ProxyRequests Off

Alias /moin_static160/ "/usr/share/moin/htdocs/"

<Location /exwiki/>
    ProxyPass http://localhost:8000/
    ProxyPassReverse http://localhost:8000/
    RequestHeader set X-Moin-Location /exwiki/
</Location>

Now restart Apache and test your wiki at http://localhost/exwiki/ or http://www.example.com/exwiki/

This setup was tested on Mac OS X.

On Debian Sarge, the default Apache configuration denies all proxy access, so at least the following should be added:

<Proxy http://localhost:8080/>
  Order deny, allow
  Allow from all
</Proxy>

$/!\$ If you ever change the value of the X-Moin-Location header, you may have to manually delete cached data for the change to show up in wiki pages. See MoinMoinBugs/SiteLocationIgnoredOnEditPage for details.

Integrating with Apache 2

Standalone or Twisted setup

Apache 2 setup