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.

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:

• [a-z] — lowercase letters
• [0-9] — digits
• [_$()+,/]

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 http://127.0.0.1:5984/

To show all databases, the command is:

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

To create a new empty document:

curl -X PUT http://127.0.0.1:5984//name -H "Content-Type: application/json" -d {}

To create a document with content:

'{ "First": "Will" }'

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