Skip to content


Subversion checkout URL

You can clone with
Download ZIP
A realtime chat server for CouchDB
Branch: master
Failed to load latest commit information.
evently First commit.
filters First commit.
lists First commit.
vendor/couchapp First commit.
views/messages First commit.
.couchappignore First commit.
.couchapprc First commit. First commit.
_id First commit.
couchapp.json First commit.
language First commit.
rewrites.json First commit.

CouchChat: A realtime chat server for CouchDB

This is a simple demo app that I use when talking about CouchDB. I'm actively developing it, but its currently in a very alpha state. More good stuff to come.

This project was inspired by the awesome Toast project by jchris, but all the code is my own (so if there is anything funky, the blame is mine).

Deploying this app

Assuming you just cloned this app from git, and you have changed into the app directory in your terminal, you want to push it to your CouchDB with the CouchApp command line tool, like this:

couchapp push . http://name:password@hostname:5984/mydatabase

If you don't have a password on your CouchDB (admin party) you can do it like this (but it's a bad, idea, set a password):

couchapp push . http://hostname:5984/mydatabase

If you get sick of typing the URL, you should setup a .couchapprc file in the root of your directory. Remember not to check this into version control as it will have passwords in it.

The .couchapprc file should have contents like this:

  "env" : {
    "public" : {
      "db" : ""
    "default" : {
      "db" : "http://name:pass@localhost:5984/mydatabase"

Now that you have the .couchapprc file set up, you can push your app to the CouchDB as simply as:

couchapp push

This pushes to the default as specified. To push to the public you'd run:

couchapp push public

Of course you can continue to add more deployment targets as you see fit, and give them whatever names you like.

Something went wrong with that request. Please try again.