Foswiki on Mac OS X (Snow)Leopard

Overview

This topic provides an installation of Foswiki on MacOS 10.5.x (Leopard) and 10.6.x (Snow Leopard) under /Library/Webserver/Documents/foswiki.

---

Download Installer Package

• Foswiki-1.1.2-1.dmg: Foswiki-1.1.2-1 disk image for MacOS 10.5/10.6 ( GPG signature)
  • To verify: $ gpg --verify Foswiki-1.1.2-1.dmg.asc Foswiki-1.1.2-1.dmg

Installation Instructions

• Mount disk image
• Click Foswiki-1.1.2-1.pkg and follow installation instructions
• Point your browser to http://127.0.0.1/foswiki/bin/view and fire away

This is a basic installation, perfect for personal use on a local computer.

This installation is NOT meant to be run on a public server, accessible by everybody on the internet. In order to set the appropriate security level of your installation please refer to http://127.0.0.1/foswiki/bin/view/System/InstallationGuide.

To make the installation as simple as possible, a couple of configuration settings have already been applied by the installer:

• LoginManager and EnableNewUserRegistration have been switched off
• Switched Store Implementation to RcsLite
• Adjusted some pathes
• To change your configuration point your browser to http://127.0.0.1/foswiki/bin/configure
• Configure password is set to foswiki

Making your Foswiki automatically findable by bonjour

If you would like your Foswiki to be findable by bonjour, for example from the bonjour section in Safari's bookmarks window, you can add a directive to your foswiki apache config file:

<IfModule bonjour_module>
    RegisterResource "My Foswiki" "/foswiki/bin/view" 80
</IfModule>

Note, the bonjour apache module in Leopard is broken, and doesn't let you register multiple resources. If you need this ability, see http://habilis.net/mod-bonjour-fix/ for a fixed module.

-- GavinBaker - 20 Jul 2009

Uninstalling Foswiki

Open Terminal

• sudo  rm -rf /Library/Webserver/Documents/foswiki
• sudo  rm -rf /Library/Webserver/Documents/Foswiki-1.1.2
• sudo  rm -f /etc/apache2/other/foswiki_httpd.conf

Trouble shooting

If something is not working properly, check out /var/log/apache2/error_log as usual.

A bunch of quite old trouble shooting tips have been removed from this page and put here for reference: FoswikiOnMacOSXTroubleShooting

-- Authors: MatthiasWientapper, WillNorris