= MoinMoin How-Tos = These are community-maintained how-to's. This is a wiki, feel free to improve or add your own. This is intended to supplement, not replace, the official docs (see [[Documentation]]). == Using the HowTos == '''Reading''': compare your moin version with the version the !HowTo is about <
> '''Searching''': add `t:re:^HowTo/` to your query <
> '''Asking''': use the !HowTo page to ask questions about it <
> '''Writing''': log in, collaborate on the !HowTo page, subscribe it <
> '''Creating''': log in, edit this page, add a subpage link, create subpage using HowToTemplate ----- == Installation == * [[HowTo/ModWsgiExpress|Quick guide for desktop wiki in virtual python]] - ''~-up and running with one line wikiconfig.py change-~'' * [[HowTo/Debian8|Guide for setting up a wiki on Debian 8]] - ''~-based on !MoinMoin 1.9.8 and recent Debian 8-~'' * [[HowTo/UbuntuQuick|Quick guide for setting up a first wiki on Ubuntu]] - ''~-based on !MoinMoin 1.9 and recent Ubuntu (9.10 - 15.04).-~'' * [[HowTo/CentOSQuick|Quick guide for setting up a first wiki on Centos]] - ''~-based on !MoinMoin 1.9 and CentOS 5.X.-~'' * [[HowTo/SUSELinuxEnterpriseQuick|Quick guide for setting up a first wiki on SUSE Linux Enterprise Server]] - ''~-based on !MoinMoin 1.9 and SLES 10 SP3.-~'' * [[HowTo/FreeBSDQuick|Quick guide for setting up a first wiki on FreeBSD]] - ''~-based on !MoinMoin 1.9 and FreeBSD 9.1-RELEASE.-~'' * [[HowTo/UbuntuFarm|A wikifarm example with basic features]] - ''~-based on !MoinMoin 1.9 and Ubuntu 9.10 Karmic Koala.-~'' * [[HowTo/BeginnersLinux|Management of MoinMoin wikis for beginners]] - ''~-based on !MoinMoin 1.8 and 1.9, Apache and Linux (RHEL5). Upgrade instructions for MoinMoin 1.5-1.8.-~'' * [[/Run Moin from a Mercurial work directory]] - ''~-easy way to keep up-to-date with some moin repo-~'' * [[/Run Moin using the download archive]] - ''~-easy way to run moin using the download archive-~'' * [[HowTo/WindowsWithApacheServer|Windows with Apache Server]] - ''~-standard Apache or VisualSVN's Apache distribution.-~'' * [[HowTo/MacOSXwithApacheServer|MacOS X with Apache Server]] * [[HowTo/MoinOnIIS|Moin on Windows Internet Information Server]] * [[/Install a new Python on a old Linux system]] - ''~-if your Python is below !MoinMoin's requirements.-~'' * [[HowTo/Install MoinMoin under sudo, setuid, or setgid wrapper|Install MoinMoin under sudo, setuid, or setgid wrapper]] - ''~-sudo(8), setuid(2), and setgid(2) are often chosen to implement security policies on POSIX, unix (incl. linux) platforms with or without Apache.-~'' * /ApacheWithCherryPy - ''~-for Apache 1.3, using CherryPy for WSGI-~'' * ''~-MoinMoin installation [[via_ftp_on_vserver|via ftp on vserver]] (Domainfactory-~'') == Upgrading == * [[/Migrate from 1.5 to 1.6]] - ''~-(and beyond) for Linux or other POSIX systems.-~'' * [[RickVanderveer/UpgradingFromMoin15ToMoin16|Rick's Guide to Upgrading from 1.5 to 1.6]] - ''~-A slightly Windows-centric guide to upgrading from 1.5 to 1.6.-~'' * [[RickVanderveer/UpgradingFromMoin16ToMoin17|Rick's Guide to Upgrading from 1.6 to 1.7]] - ''~-A slightly Windows-centric guide to upgrading from 1.6 to 1.7.-~'' * [[RickVanderveer/UpgradingFromMoin17ToMoin18|Rick's Guide to Upgrading from 1.7 to 1.8]] - ''~-A slightly Windows-centric guide to upgrading from 1.7 to 1.8.-~'' * [[RickVanderveer/UpgradingFromMoin18ToMoin19|Rick's Guide to Upgrading from 1.8 to 1.9]] - ''~-A slightly Windows-centric guide to upgrading from 1.8 to 1.9.-~'' * [[EricVeirasGalisson/MoinMoinMigration|Eric's guide to upgrade MoinMoin]] - ''~-A Linux-oriented guide, as possible up to date to the current moin version.-~'' == Configuration == * [[HowTo/ApacheWithModWSGI|Configuring mod_wsgi for Apache]] - ''~-The recommended Python accelerator for Moin-~'' * see also the slides about [[http://modwsgi.googlecode.com/files/mod_wsgi-pycon-sydney-2010.pdf|using mod_wsgi]] (not moin-specific) * [[HowTo/NginxWithUwsgi|NGINX with uWSGI]] - ''~-An alternative that uses less memory-~'' * [[HowTo/NginxWithModWSGI|Configuring mod_wsgi for NGINX]] - ''~-(note that this is a -~''~-different'' mod_wsgi)''-~ * [[HowTo/UbuntuAD|An Active Directory authentication example]] - ''~-based on !MoinMoin 1.9 and Ubuntu 9.10 Karmic Koala.-~'' * [[HowTo/WindowsDomainAuthentication|Windows Domain Authentication]] - ''~-Leveraging Moin & Apache auth for Windows Domain Authentication-~'' * [[/Setup Moin with WSGI Apache HTTPAuth]] - ''~-Linux, POSIX, Apache2, http auth-~'' * [[HowTo/ApacheWindowsFastCGI|Configuring FastCGI & Apache on Windows]] - ''~-mod_wsgi is the preferred accelerator for Windows (and Moin in general), however these instructions are retained because it may be adaptable for IIS or other servers where mod_wsgi is not an option.-~'' * [[http://projects.unbit.it/uwsgi/wiki/Example#MoinMoinonlinenow|Configuring with uWSGI]] * [[HowTo/FedoraSELinux|Running Moin on Fedora with SELinux]] * [[HowTo/LdapConfiguration|How to configure the openldap interface for the moin ldapauth script]] - to be defined * [[HowTo/AdvancedEmailSetup|How to configure email]] * [[HowTo/ExternalCreationCheck| How to perform external_creation_check on new accounts]] == Administration == * [[HowTo/backUpOnWindows|Backup on Windows]] - ''~-An easy Moin backup solution for Windows-~'' * [[/Tune Performance]] - ''~-make your wiki faster and cause less load-~'' * /ManagingAccountCreation - ''~-controlling & restricting user accounts-~'' ---- = TODO = * !HowTo authors, please move your stuff to here. While you're at it, add a header like you see on HowToTemplate and check if stuff is still valid. * After http://master18.moinmo.in/ is switched to read only (likely some time after 1.9 release), we should create !HowTos from the installation / server specific stuff there that is not contained on master19 wiki, but still up-to-date and useful.