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

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:

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

  4. configure MojoMojo

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

  • 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.