view docs/admin/requirements.rst @ 2314:42d4f773ca4a

rewrite requirements.rst, install.rst, and development.rst to document
author RogerHaase <>
date Sun, 12 Jan 2014 11:45:03 -0700
parents 38b5c2746f83
children 264e4015212e
line wrap: on
line source

MoinMoin requires Python 2.7.x. A CPython distribution is
recommended because it will likely be the fastest and most stable.
Most developers use a CPython distribution for testing.
Typical linux distributions will either have Python 2.7 installed by
default or will have a package manager that will install Python 2.7
as a secondary Python.
Windows users may download CPython distributions from or

An alternative implementation of Python, PyPy, is available

The `virtualenv` Python package is also required. The
installation process for `virtualenv` varies with your OS and
Python distribution.
Many linux distributions have a package manager that may do
the installation. Windows users (and perhaps others) may download
setuptools from Once setuptools is installed, do "`easy_install virtualenv`". Current ActiveState
distributions include virtualenv in the installation bundle.
If all else fails, try Google.

Mercurial (hg) is required should you wish to contribute
patches to the moin2 development effort. Even if you do not
intend to contribute, Mercurial is highly recommended as it
will make it easy for you to obtain fixes and enhancements
from the moin2 repositories. Mercurial can be installed
with most linux package managers or downloaded
from As an alternative,
most Windows users will prefer to install TortoiseHG
(includes Mercurial) from


For moin2, you can use any server compatible with WSGI:

* the builtin "moin" server is recommended for desktop wikis, testing,
  debugging, development, adhoc-wikis, etc.
* apache with mod_wsgi is recommended for bigger/busier wikis.
* other WSGI-compatible servers or middlewares are usable
* For cgi, fastcgi, scgi, ajp, etc., you can use the "flup" middleware:
* IIS with ISAPI-WSGI gateway is also compatible:


Dependent packages will be automatically downloaded and installed during the moin2 installation process. For a list of dependencies, see

On the client side, you need:

* a web browser that supports W3C standards HTML 5, CSS 2.1, and JavaScript:

  - any current version of Firefox, Chrome, Opera, Safari, Maxthon, Internet Explorer (IE9 or newer).
  - use of older Internet Explorer versions is not recommended and not supported.

* a Java browser plugin is required only if you want to use the TWikiDraw or AnyWikiDraw drawing applets.