Installing MojoMojo

On FreeBSD, install the p5-MojoMojo package. A Debian package for MojoMojo will soon be available.

TODO: document where files end up after installation. (alternatively, run updatedb and locate mojomojo_server.pl)

System Requirements

• Perl 5.8+ and Catalyst 5.7+
• database: in theory, any database back-end supported by DBIx::Class. MojoMojo has been successfully tested with SQLite, PostgreSQL and MySQL.
• memory requirements: on Linux, 60Mb per FastCGI process, regardless of the wiki database size or back-end type
• external library dependencies:
  • libxml2 for Atom feeds
  • image manipulation libraries for attachment support, required by Imager: libpng-dev, libgif-dev, libjpeg-dev (or libjpeg62-dev)

Installation from CPAN

1. install Catalyst. This can be as easy as cpan Catalyst::Runtime

2. install the external libraries. For example on Ubuntu, run:

   aptitude install libxml2 libpng-dev, libgif-dev, libjpeg-dev
   

   On Windows, you can find libxml2 and its dependencies at http://www.zlatkovic.com/pub/libxml/. You'll need libxml2.dll, iconv.dll and zlib1.dll in a directory listed in PATH.

3. install MojoMojo:

   • latest stable version
   • latest build

   To see how likely the installation tests are to succeed, check the CPAN Testers status of the MojoMojo dependencies.

   As with any Catalyst application, mojomojo_*.pl scripts will be installed installed in /usr/local/bin.

4. configure MojoMojo

   To point MojoMojo to an arbitrary configuration file, set

   MOJOMOJO_CONFIG=/my/other/path.conf
   

Here is an older example installation progress.

Installing the latest build from GitHub, step-by-step

apt-get install libpng12-dev libjpeg62-dev libxslt1-dev libgdbm-dev docbook-xsl docbook-xsl-doc-html
apt-get install git-arch
git clone git://github.com/marcusramberg/mojomojo.git
cpan -i Module::Install
cd mojomojo
perl Makefile.PL
make
make test
# change mojomojo.conf if necessary
script/mojomojo_spawn_db.pl  # creates database
script/mojomojo_server.pl  # launch development server

From here on, see Deployment. If you run into problems, see Troubleshooting.