Calipso is a simple NodeJS content management system, built along similar themes to Drupal and Wordpress, that is designed to be fast, flexible and simple.

For additional detail, please visit the home page: http://calip.so/

If you would like to contribute, please take a look at the issues list as this will have the most up to date view of work that needs to be done for the next minor release. Otherwise, please just pm myself (cliftonc) or dennis (dennishall) and we can suggest some palces for you to start.

Pre-Requisites

First things first, you need to get your basic environment right, the pre-requisites are:

• NodeJS : Installation Guide [0.4.2 @ time of writing, but also tested on 0.4.7]
• NPM : Installing NPM
• MongoDB : Download / Install
• A git client (to access the source code on Github).

Ok – good to go?

Grab the source …

Go to where you want to run calipso from (e.g. /var/www).

cliftonc@clifton-laptop:/var/www/tmp$ git clone git@github.com:cliftonc/calipso.git

Initialized empty Git repository in /var/www/tmp/calipso/.git/
remote: Counting objects: 724, done.
remote: Compressing objects: 100% (440/440), done.
remote: Total 724 (delta 298), reused 520 (delta 216)
Receiving objects: 100% (724/724), 640.07 KiB | 476 KiB/s, done.
Resolving deltas: 100% (298/298), done.

cliftonc@clifton-laptop:/var/www/tmp$ cd calipso/

cliftonc@clifton-laptop:/var/www/tmp/calipso$ ls
app-cluster.js  conf       lib       media    package.json  README   test    utils
app.js          docs.html  Makefile  modules  pids          support  themes

Ok, now grab all the dependencies via NPM

Calipso depends on a number of other libraries that are available through NPM (the Node Package Manager). If all of these dependencies aren’t installed, you will get lots of errors when attempting to run Calipso

cliftonc@clifton-laptop:/var/www/tmp/calipso$ npm install
npm info it worked if it ends with ok
npm info using npm@0.3.15
npm info using node@v0.4.2
npm info link /var/www/tmp/calipso

...
<<YOU WILL SEE LOTS OF DOWNLOADS DEPENDENDING ON WHAT YOU ALREADY HAVE INSTALLED>>
...

npm ok

cliftonc@clifton-laptop:/var/www/tmp/calipso$

Ok – lets run it!

Now the first test, try to run it!

cliftonc@clifton-laptop:/var/www/tmp/calipso$ node app

            _ _
  ___  __ _| (_)_ __  ___  ___
 / __|/ _` | | | '_ \/ __|/ _ \
| (__| (_| | | | |_) \__ \ (_) |
 \___|\__,_|_|_| .__/|___/\___/
               |_|

Logging enabled: Console
Calipso server listening on port:  3000

Now, if you browse to:

http://localhost:3000

You should see the home screen, along with a message that the site has been configured with a default Administrative user and password. You should login with this, and then change it immediately (you can do this from the Admin users profile page).

What next?

Ok – you’re now up and running, you should be able to login, and once logged in begin to navigate the content creation and administration screens.