The following 333 words could not be found in the dictionary of 615 words (including 615 LocalSpellingWords) and are highlighted below:

about   above   add   additional   Administration   administrator   all   alone   already   alternative   an   Anchor   and   anything   anyway   Aol   Apache   applies   apply   at   Basic   be   because   before   behind   below   built   But   but   by   can   choose   commands   common   components   concrete   config   Configuration   configuration   configure   contains   Contents   cover   Creation   currently   date   de   Decide   declares   decribed   default   described   describes   detail   development   differ   different   directly   distribution   distributions   documentation   does   Does   doing   done   downloading   each   easy   edit   either   elementary   encounter   environments   equally   Especially   etc   example   examples   execute   exists   explaining   explains   expressions   farm   farmconfig   Farming   Fast   fastcgi   faster   favourite   file   files   find   fixing   following   for   from   Ftp   general   get   Getting   harder   help   Help   helps   High   home   how   How   if   If   images   in   In   Information   information   install   Installation   installation   installed   installing   Installing   installscenarios   Instance   instance   instances   instructions   interfaces   into   its   just   keyword   keywords   launcher   Lighttpd   like   linked   links   Linux   list   live   Logic   looked   Ls   Mac   made   maintenance   make   matches   matching   might   Minimal   minimal   minimalistic   mod   Mod   mode   moinmaster   more   much   multiple   must   named   never   new   next   no   Note   note   Of   of   often   On   on   Once   one   One   only   onto   operate   optional   options   or   Osx   other   out   override   own   packages   page   pages   per   performance   personal   Personal   place   platform   point   ports   precedence   predefined   prefix   presented   problems   procedure   processing   provide   proxy   Public   public   python   Python   quick   rather   read   real   regarding   regex   regular   require   run   running   same   scenario   Scenarios   scenarios   script   section   see   seek   serve   served   server   Server   servers   sessions   set   sets   Setup   setup   several   share   shared   Shooting   should   show   showing   site   slightly   slow   small   So   solution   some   Some   Sometimes   source   stand   standalone   Standalone   static   step   steps   stops   stuff   subpages   successful   support   system   Table   takes   Technical   template   tested   than   that   The   the   theme   there   these   These   they   This   this   those   to   topics   tree   trees   Trouble   trying   Twisted   two   under   understand   unless   up   Updating   upgrade   use   used   using   Using   usr   various   versions   very   visit   visitor   want   Web   web   webserver   webservers   well   what   when   where   which   wikiconfig   wikiwikiweb   will   With   with   Within   workgroup   world   would   You   you   your   yourself  


HelpContents > HelpOnAdministration > HelpOnInstalling

How to install your own MoinMoin Wiki

This page describes the installation procedure of MoinMoin. In the next section, there is a list of real-world Installation Scenarios that help you to understand how to apply the instructions in different environments. If you already have a wiki running and want to upgrade, see HelpOnUpdating.

A MoinMoin installation is done by some elementary steps:

  • /BasicInstallation explains the "" step of the installation in more detail. This is used to get the MoinMoin code and wiki template installed onto your system. This applies equally to all scenarios, and you should read it before trying a live installation.

  • /WikiInstanceCreation explains how you make a new wiki instance (data and configuration). This is also common to all scenarios.

  • Setup your webserver
    • Decide which solution you want to use (see below).
    • Getting the web server to serve static stuff under the /wiki URL (url_prefix), used for theme CSS and images, etc. This is slightly different for the various web servers that can be used - see below.

    • Getting the web server to execute the moin code when you access wiki pages. This is done either by CGI, FastCGI, mod_python or Twisted or the built-in stand alone server - this is slightly different for the various web servers that can be used - see below.
  • After a successful installation, you might want to read more about configuration and other options that you, as the wiki administrator, can set up. HelpOnAdministration contains links to pages that cover these topics. Especially, the HelpOnConfiguration and HelpOnUpdating pages provide additional information regarding wiki setup and maintenance.

  • /TroubleShooting helps with fixing any general problems you might encounter which apply to any installation platform.

Using distribution versions

As an alternative for downloading you can use of distribution packages (from your favourite Linux distribution, for example). But often those are not very up-to-date. The installation scenarios will not differ much as you will have to create new instances by yourself anyway. Some distributions have predefined configuration files where you just have to make /WikiInstanceCreation because the shared content is already in its place.

Installation scenarios

The following subpages will show you concrete examples of installation sessions, showing the commands used and explaining what they do. You must first read the general information on installing above before doing the installation steps described on the pages linked from below:

Personal wiki

Wiki for personal use or small workgroup. Does not require anything but Python and MoinMoin.

  • /StandaloneServer

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

Public wiki using CGI

CGI is very common, well tested and easy to configure but rather slow.

Standalone mode

It's very quick and can be run behind Apache's mod_proxy.

High performance public wiki

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

A minimalistic wiki

Sometimes you want to install a wiki that is only made of the minimal components. How you set this up and how you add additional components is decribed in /MinimalWiki

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 file. Copy this into the farm directory, and edit moin's launcher script ( if you are standalone, moin.cgi if you are cgi, etc.) to point directly at it. 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 the URL matches moinmoin, is looked for (and exists in the same directory as Within, 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 will never be read; the farm takes precedence.