Installation instructions

Requirements

If you want to install Cartoque, you need to check the following requirements are met :

Clients: clients should use a modern web browser (Chrome, Firefox, Safari, Opera) ; IE support is blocked since I had a lot of problems with it and I cannot test it myself (feel free to fill a new issue about this subject) ; Javascript must be enabled
Application server: you'll need Ruby 1.9.2-p290 or higher (previous versions are buggued) and an application server that supports Rails applications ; the installation of these components are out of the scope of this tutorial, but I personnaly run my production environment with Ruby 1.9.2-p290 installed with RVM, and Phusion Passenger 3.0.x in standalone mode
Database server: MongoDB version 2.0 or higher is required (support for relational databases has been dropped)
Authentication: you can use the internal authentication with login/password or a CAS server

Installing the application

This section is not complete for the moment. Basically, if you have the correct application stack and you've cloned the repository, it installs like any Rails 3 web app :

cd /path/to/cartoque
gem install bundler
bundle install
rake secret:replace db:migrate cartoque:seed

Start the server, open your browser in the correct URL, and you're ready to go !

NB: the default login/password (admin@example.net/admin) is advertised on the login page the first time you log in. We highly recommend you change it as soon as possible, at least before going into production.