No, Kandan is not a Pokèmon. Kandan is an open source alternative to HipChat (by Atlassian) based on Ruby on Rails that offers you a private chat system. This tutorial will show you how to install Kandan on an Ubuntu 12.04 Server with Apache running. If you are running Plesk you will find additional instructions on how to set up Kandan with Plesk.
Requirements for Kandan on Ubuntu 12.04
The following things are required to run Kandan. There are links to installation tutorials for each required part.
Install Kandan on your Ubuntu server
Now we will install Kandan with the standard settings and try if we can connect to the app. Follow the instructions:
- First we need to download the app files to our server. You can choose between using Git or the built-in wget:
git clone https://github.com/kandanapp/kandan.git
cd /opt/ wget https://github.com/kandanapp/kandan/archive/master.zip unzip master.zip mv master kandan
- Perfect. You have the Kandan app files now. Let’s take a look into the directory:
- Now we need some other required stuff to run Kandan without any problems and prepare to install Kandan.
sudo apt-get install ruby1.9.1-dev ruby-bundler libxslt-dev libxml2-dev libpq-dev libsqlite3-dev
- If the bundler ran without any errors you can go ahead. If there are errors, bundler should have told you how to solve it. If you are stuck, leave a comment. But now we have to configure your database for Kandan.
su – postgres
- We have created the database but we still need a user with password:
CREATE USER kandan WITH PASSWORD 'yourpasswordhere';
- Woot! We have a database for Kandan. Let’s tell Kandan about it.
cd /opt/kandan/config nano database.yml
You should see some predefined options for develompent and tests. But we want a production environment. Paste this with your password above the develompent section:
production: adapter: postgresql host: localhost database: kandan_production pool: 5 timeout: 5000 # You might need these depending on your Postgres auth setup. username: kandan password: yourpasswordhere
You can save and exit with
ctrl + xthen
yand then press
- You are ready to install and run the app now. Do it!
bundle exec rake db:create db:migrate kandan:bootstrap bundle exec thin start
You should see how Kandan starts. Leave the terminal now and user the following address to access Kandan:
If the Login screen shows up you are ready to configure Apache / Plesk so you can access Kandan from http://chat.youdomain.com/
If you want to spend some time with Kandan you can access the app with the username Admin and the password kandanappadmin
If you are ready to go please shut down Kandan with ctrl + c
Configure Apache / Plesk to run with Kandan
It is very easy to setup Apache to run with Kandan. Just paste this to the virtualhosts file of a subdomain / domain.
ProxyPreserveHost On ProxyPass / http://localhost:3000/ ProxyPassReverse / http://localhost:3000/
If you are using Plesk (> v11) you can add these lines under the following menu: Home panel > yourdomain.com > Websites & Domains > Select your subdomain here and open the settings panel below it > select Webserver-Settings and paste the lines in the textarea for additional HTTP instructions
Setup Kandan as a service so it will start after reboot
Maybe you noticed that Kandan started in your terminal session and wanted to stay there. If you close your terminal the app shuts down. If you want to load the app on reboot of your Ubuntu server you can easily follow the following instructions:
nano /etc/init.d/kandanand paste the following lines into the editor.
#! /bin/sh case "$1" in start) cd /opt/kandan && bundle exec thin start -d ;; stop) cd /opt/kandan && bundle exec thin stop ;; restart) cd /opt/kandan && bundle exec thin restart -d ;; esac exit 0
If you are ready you can save and exit with
ctrl + xthen
yand then press
- Now we can add the service to the reboot so the app starts when the machine is booting up.
sudo update-rc.d kandan defaults
If you have any suggestions / problems please leave a comment. If you have problems with the app itself please add write an issue report at the Kandan Github repository.