Will Holcomb

11 March 2010


A process log of me working through the IBM tutorial and O'Reilly book to run CouchDB.


There's an aptitude package, so I just ran sudo aptitude and installed couchdb. In the process, I discovered there is already an instance running on my machine.

Creating a Database

Post-install, there is a web endpoint on port 5984 which communicates via JSON.

A utility webapp is also available.

Database names have to be:

I created the database: organization/department/happiness/will. The slashes have to be urlencoded, so it is: organization%2Fdepartment%2Fhappiness%2Fwill/name The curl command is:

curl -X PUT

Listing the Database

To show all databases, the command is:

curl -X GET http://localhost:5984/_all_dbs

Adding A Value

To create a new empty document:

curl -X PUT -H "Content-Type: application/json" -d {}

To create a document with content:

'{ "First": "Will" }'

Test Program

Next I created a program to test out some of the basic functionality: