Installation

Instructions on getting up and running with Kanso's command-line

  1. Step 1. Install CouchDB

    Installing on Mac OSX

    Warning: Some people have found the Homebrew install to have broken regular expressions, use build-couchdb if you have problems.

    brew install couchdb

    Installing on Ubuntu

    Warning: The version of CouchDB available in the Ubuntu repositories is now quite old. If possible, try installing from source using build-couchdb or the instructions on the CouchDB wiki.

    sudo apt-get install couchdb

    Windows Installer

    Note: Kanso is not yet officially supported on Windows, though some people have had success getting it to run with Cygwin. See the Installing on Windows wiki page.

    Compile from source

    For help compiling on your system, see the CouchDB Wiki.

  2. Step 2. Install Node.js

    Kanso supports the latest stable version of Node.js (v0.6.x).

    Why does Kanso need node.js?

    Node.js is used for the command-line tools only. With Kanso, the end result is a pure CouchApp you can host using CouchDB alone. Using node to write the associated tools allows us to do some powerful things by interpreting the JavaScript of your application.

    Get Node.js

  3. Step 3. Install Kanso command-line

    Kanso Logo

    Install using NPM

    sudo npm install -g kanso

    Windows

    If you're on windows you'll have to use Kanso with cygwin until Windows is officially supported. See the Installing on Windows wiki page for more information.

Next: Simplest possible app