To install cerise simply download the latest release and extract it somewhere. You'll end up with a cerise-x.x directory containing the following subdirectories as well as the cerise code itself:

    apps    - applications, each in its own directory
    cfg     - server configuration files
    doc     - documentation
    lib     - library files
    log     - log files
  

Now cerise is ready to run:

    $ ruby server.rb
    [2004-07-01 12:01:00 #112]  INFO cerise/0.7 started
    [2004-07-01 12:01:00 #112]  INFO ruby 1.8.1/2003-12-25 (powerpc-darwin)
  

cerise listens for HTTP requests on port 8000 per the default setting configured in server.cfg, so you can try the sample applications at http://localhost:8000/examples/

To shut down the server simply press ^C (control-c). On Windows you'll have to make another request to the server to get it to terminate properly.

Applications

Each application has its own directory in cerise/apps. When building your own applications you will want to create the following directory structure:

    cerise/apps/<my-app>/
    cerise/apps/<my-app>/app.cfg     - the application configuration file
    cerise/apps/<my-app>/content/    - the app's code and templates
  

The easiest way to create your own app.cfg is to copy the one in cerise/apps/examples/app.cfg and modify it for your needs.

Common Libraries

If you want a ruby library to be available to all of your applications you can place it in a subdirectory of cerise/lib/. When cerise starts up it will add all of the subdirectories to the ruby load path. Then a require 'library' will be all that is necessary to access that library.

Libraries that are added to cerise/lib/ while cerise is running will not be added to the load path until cerise is restarted.