= About DesktopEdition =
!MoinMoin is easy to run in what we call "desktop mode", which makes it great for evaluating, demonstrating, or simply using as a personal wiki. All with very little setup or configuration.

== Download & Installation ==
Getting and installing !MoinMoin is as easy as 1 - 2 - 3!

Moin uses Python (2.4, 2.5, 2.6 will work, 3.x [[Python3|won't work yet]]), which is already installed on most linux distributions and all recent versions of Mac OS. Windows will require a quick and painless install of Python.

 1. '''Download !MoinMoin'''
  * MoinMoinDownload
 1. '''Extract into a directory of your choice'''
  * If you are updating, you may just overwrite the existing files, but that way you will lose your changes in the configuration files '''wikiserverconfig.py''' and '''wikiconfig.py'''. Backup those files before upgrading so that you can restore them afterwards.
 1. '''Run ''wikiserver.py'' from the directory you extracted to:'''
  * '''Linux/Unix:'''
   * Type {{{python wikiserver.py}}} in console.

  * '''Mac:'''
   * Right-click (control-click) on the {{{wikiserver.py}}} file. From the contextual-menu, select "open with..." > "Other..."; select "All Applications", check "Always Open With", and then navigate to {{{Terminal.app}}} (located in /Applications/Utilites/). The "Always open with" sets Terminal.app as the default application, so in the future you can simply double-click the {{{wikiserver.py}}} file.

  * '''Windows:'''
   i. Download & install Python
    * http://www.python.org/download/ (we recommend Python 2.5 or 2.6)
    * the installer will automatically associate .py files with Python.
   i. Simply double-click {{{wikiserver.py}}} in the Moin folder.

Now, just point your browser to http://localhost:8080/

And it's as easy as that!

=== Limitations of DesktopEdition ===
!DesktopEdition ''is'' a full working version of !MoinMoin. However, for larger organizations and public wikis, !DesktopEdition will not offer the performance or flexibility of a standard !MoinMoin installation. A standard install will allow you to take advantage of your web server features, such as various authentication options, as well as other features of Moin. Refer to InstallDocs for help.

=== Related Links ===
 * /DesktopEditionQuestions - questions & comments on running Moin in desktop-mode.
 * /UserContributions - Expand your !MoinMoin !DesktopEdition
 * /HowToConfigure - Additional configuration options (how to change ports, allow outside connections, etc).
 * /HowToBuild - A description of the MMDE build process.
 * PersonalMoinMoin - in planning stage
 * MoinMoinAsPim - How to use a local wiki as a [[PIM]]
 * Wiki:DesktopWiki
 * [[http://sourceforge.net/project/showfiles.php?group_id=8482&package_id=151797|Previous Releases]] of !DesktopEdition.

##
##    In effort to keep this page clean and inviting to new users, let's keep this page
##    confined to simply how to get desktop edition up and running.
##
##    For questions & comments, please use the sub-page: /DesktopEditionQuestions
##
##    Thank you.
##