HelpForAdministrators > HelpOnInstalling

The following guides will walk you through concrete examples of installation scenarios, showing the commands used and explaining what they do. ( /!\ For standard wiki installations you need to do a /BasicInstallation. )

Installation Guides

Standard Wiki installations

Public wiki using CGI

CGI is very common, well tested and easy to configure, but slower compared to solutions below.

Standalone mode

Very quick and can be run behind Apache's mod_proxy.

Technical note: Standalone is faster than Twisted currently, but does not support multiple interfaces/ports.

High performance public wiki

These servers are much faster than CGI, but might be harder to install and configure.

Next Steps

After a successful installation, you might want to read more about configuration and other options that you, as the wiki administrator, can set up.

<!> A note about using Distribution versions: Some Linux distributions come pre-packaged with MoinMoin already installed. However, chances are that the distributed version is out of date from the current version. The installation scenarios will not differ much as you will have to create new instances by yourself anyway.

Wiki Farming

One copy of moinmoin source code can be used to operate more than one wiki. Create a directory for your farm, and under it, make two data trees per the /WikiInstanceCreation instructions. In the config directory (by default /usr/share/moin/config) you will find an example farmconfig.py file. Copy this into the farm directory, and edit moin's launcher script (moin.py if you are standalone, moin.cgi if you are cgi, etc.) to point directly at it.

farmconfig.py declares regular expressions for each wiki "tree" you would like - several trees make a tree farm. It also sets the default wikiconfig options (see HelpOnConfiguration).

Once a URL matches, its keyword is used to seek out an additional (but optional) configuration file. The example describes the moin home site and its documentation development tree (moinmoin and moinmaster). So, when you visit http://moinmo.in/ the URL matches moinmoin, moinmoin.py is looked for (and exists in the same directory as farmconfig.py). Within moinmoin.py, the options override the farmconfig, wikiconfig processing stops, and the moinmoin data tree is served to the visitor.

Note that URLs matching no regex at all will not be served by moin. If you are in standalone mode, an error page will be presented. Also note that unless one of your keywords is wikiconfig any file named wikiconfig.py will never be read; the farm takes precedence.

Alternative Installs

  • DesktopEdition - A Wiki for personal use or small workgroup. Because it's extremely easy to set up on any system, DesktopEdition is excellent for evaluating or demonstrating MoinMoin's capabilities.

  • /MinimalWiki - A minimalistic wiki Instructions for installing a wiki with only minimal components.