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

above   according   action   added   address   afraid   again   Alias   Aliases   and   another   Apache   apachectl   Apple   asked   at   be   because   belong   belongs   below   better   bin   Bookmarks   both   Bugs   but   by   called   can   cd   changed   chmod   choose   chown   commands   comments   conf   config   Configuration   configuration   Configure   configure   Configuring   Control   convenient   Copying   cp   created   Creating   creation   dangerous   Darwin   de   default   Desktop   desktop   don   Download   edit   Edit   editor   emacs   engine   enter   etc   everything   example   except   exit   Expander   Extract   fail   faster   features   file   files   fine   finished   Fink   Firefox   folder   following   For   for   framework   Frameworks   from   Front   Get   give   go   Go   graceful   gracefully   group   gz   harder   help   Help   home   htdocs   httpd   if   If   in   In   Install   install   installation   installed   Installing   Installs   Instance   instance   instead   instructions   into   just   Library   like   Live   ll   local   localhost   Mac   make   many   mkdir   more   Mozilla   much   must   mywiki   name   need   net   new   New   Note   Now   of   On   on   once   one   open   Open   Optional   Or   or   overwritten   owner   page   Page   password   path   Permissions   Personal   pico   please   Ports   possible   Preferences   privileges   problem   procedure   projects   put   python   Python   pyxml   read   repeat   report   reserved   Restart   restarted   results   root   run   running   rw   rwx   safely   safer   save   sbin   Script   section   Security   see   select   serve   server   Setting   setup   several   share   shared   Sharing   shell   should   site   Sites   software   some   source   sourceforge   specific   Start   step   Stop   Stuffit   substitute   such   sudo   supplied   support   sure   surf   System   system   tar   template   terminal   test   Testing   tests   text   that   The   the   then   There   these   this   through   to   try   type   ug   underlay   unit   Unless   unless   Untitled   upgrade   Use   use   used   user   username   using   usr   values   version   Versions   want   warning   We   Web   web   When   when   where   wikiconfig   wikiwikiweb   will   with   without   working   xzf   You   you   your   Your   yourself  

Clear message

You must not be afraid to use the terminal. It is possible but much harder to install without using the terminal.

There are 2 step in the installation:

  1. Install the MoinMoin engine - once

  2. Create wiki instance. You can create and serve as many wikis as you like.

Installing MoinMoin


Download the source on the Desktop. You should see a moin-1.3.tar.gz file. Extract this file on the desktop with Stuffit Expander, or from the terminal (faster and safer):

cd ~/Desktop
tar -xzf moin-1.3.0.tar.gz

Install procedure

Use these commands in the terminal to install the MoinMoin wiki engine into the system.

First, open a shell as root. You will need this to install MoinMoin and configure the wiki. When asked, enter your password.

sudo -s
... password:

Now you have root privileges in this shell.


cd moin-1.3.0
python install --install-data='/usr/local'

Now the installation is finished. You will not have to repeat this step unless you upgrade moin.

Optional Installs


If you want your wiki to support RSS and Mozilla Firefox Live Bookmarks features, you have to install PyXML. Get PyXML from and install according to the instructions.

Creating a wiki

After you have installed the software, you need to create a wiki. You may create several wikis if you need.

Copying a template wiki

Copy a template wiki from the /usr/local/share/moin. Do not try to run the wiki from /usr/local/share/moin/data because your wiki will be overwritten when you install a new version of moin.

The following instructions will create a wiki called "mywiki". You can choose any name you like, except the reserved name "wiki".

Do these commands:

cd /usr/local/share/moin
mkdir mywiki
cp -r data mywiki
cp -r underlay mywiki
cp server/moin.cgi mywiki
cp config/ mywiki

Setting Permissions

You have to make the web server the owner of the files in your wiki. Unless you changed the default configuration, both are 'www'.

chown -R www:www mywiki
chmod -R ug+rwX mywiki
chmod -R o-rwx mywiki

Configure Apache

We'll use the pico editor:

pico /etc/httpd/httpd.conf

Go to the end of the Aliases section and edit like the example below:

    Alias /wiki/ "/usr/local/share/moin/htdocs/"      
    ScriptAlias /mywiki "/usr/local/share/moin/mywiki/moin.cgi"       

Use Control+O to save the file and Control+X to exit pico.

Restart Apache - open System Preferences, go to the Sharing page, select "Personal Web Sharing" and click "Stop" then "Start". Or just type this instead:

apachectl graceful
... /usr/sbin/apachectl graceful: httpd gracefully restarted

Instance creation finished - exit from the shell with the root privileges - working as root is dangerous.


Now you are running again safely.

Testing Your New Wiki

In a web-browser surf to the site: http://localhost/mywiki

You should see the FrontPage of your new wiki.

Now run the unit tests, to make sure everything is fine. Go to this address: http://localhost/mywiki?action=test

You should see a report on the wiki and tests results for the MoinMoin engine. If some of the tests fail, please report the problem on MoinMoinBugs.

Configuring Your wiki

The wiki you created is a new "Untitled Wiki", using the default configuration. You want to give a better name and setup some configuration values. Open and read the comments. You can edit the file with any text editor, like pico, emacs, or BBEdit.

For more help on configuration, see HelpOnConfiguration.

HelpOnInstalling/ApacheOnMacOsx (last modified 2007-01-22 09:11:30)