Skip to content


Subversion checkout URL

You can clone with
Download ZIP
Fetching contributors…

Cannot retrieve contributors at this time

103 lines (75 sloc) 4.213 kB

Kandan - Modern Open Source Chat

The slickest chat app out there. Open-source and well-supported to boot.

Standard Features

These are features that work out of the box on any provider:

  • Easy deploy to CloudFuji, CloudFoundry, Heroku, dotCloud, etc.
  • Collaborative team chat
  • Unlimited channels
  • Embed formats for images and youtube videos with requests for others (twitter, facebook, g+, etc.)
  • Synchronized sound player - play any audio-tag compatible url for the whole channel (Pending :P)
  • /me command!
  • Highly extensible plugin format

CloudFuji Extended Features

In addition to the standard features above, Kandan can take advantage of CloudFuji features when run on our cloud:

  • One-click deploy
  • Team-aware: Setup your team once, and have them in every CloudFuji app
  • Event-aware: Build widgets that display build status, customer signups, website status, and much more



If you're part of the CloudFuji Beta you should already have access to Kandan with all the enhanced features from the app store.

Just click launch on here; you and your team should be all setup.

Cloud Foundry

Looking for community help here


You'll need to have the heroku gem installed and to have an existing heroku account. Assuming that, this should work reliably on Heroku:

git clone
cd kandan
heroku create --stack cedar
git push heroku master
heroku run rake db:migrate kandan:bootstrap && heroku open
echo "Done, go forth and chat!"
# Not too bad

Your app should be up and running now. The admin email by default is with password kandanadmin, or you can sign up as another user.


Looking for community help here.

Masochist server install

If you're looking to install Kandan on a private server (why??) then here are some notes you'll want to read:

# For development-mode
sudo apt-get install nodejs # (execjs needed an execution environment)
gem install execjs # (maybe I could have just added this to the gemfile?)

# Add this to the gemfile:
group :development do  
  gem 'sqlite3'

# Get the new gems
bundle install

# Use the default database.yml to get started
cp config/database.yml.sample config/database.yml

# Edit config/database.yml if you want to use postgres/mysql

# Bootstrap the install
bundle exec rake db:create db:migrate kandan:bootstrap
bundle exec rails server


See the issue tracker

Get Involved!

That's not a question, it's an order! Or more of a friendly offer, really. Kandan is a fully open-source app, so dive in and start adding features, fixing bugs (what bugs?), and cleaning up the code.


  • CloudFuji for leading and sponsoring the initial development of Kandan
  • Sacha Greif for his amazing design job and exacting implemntation standards on Kandan. A wonder and a pleasure to work with.
  • Andrew Hampton For the initial manual server install instructions


Kandan's code and assets are dual-licensed. Kanda is available generally under the AGPL, and also under a custom license via special agreement. See LICENSE for the AGPL terms, and contact us at if you're interested in development of Kandan under a custom license.

Jump to Line
Something went wrong with that request. Please try again.