Connecting PouchDB to Cloudant on IBM Bluemix

Share this post:

Republished from Raymond Camden’s Blog


pouchdb So, as always, I tend to feel I’m a bit late to things. Earlier today my coworker Andy Trice was talking to me about PouchDB. PouchDB is a client-side database solution that works in all the major browsers (and Node.js) and intelligently picks the best storage system available. It is even smart enough to recognize that while Safari supports IDB, it doesn’t make sense to use it and switches to WebSQL. It has a relatively simply API and best of all – it has incredibly simple sync built in.

I tend to work with client-side databases with just the vanilla JavaScript APIs available to them, but honestly, after an hour or so of using PouchDB I can’t see going back. (And yes, I know other solutions exist too – and I’m going to explore this area more.) Probably the slickest aspect is the sync. If you have a CouchDB server setup, you can set up automatic sync between all the database instances in seconds. For my testing, I decided to use IBM Bluemix. This blog post assumes you’re following the PouchDB Getting Started guide.

First, add the Cloudant NoSQL DB service to your Bluemix app:

After you have added the service and restaged your app, select it, and then hit the Launch button:

This fires up the Cloudant administrator where you can do – well – pretty much everything related to setting up your database. But to work with that guide at PouchDB, select Databases and then “Add New Database”:

pouchdb select new database

Then enter todos to match the guide:

Ok, you’re almost done. You then want to enable CORS for your Cloudant install. In the Cloudant admin, click Account and then CORS. Enable it, and then select what origin domains you want. For now, it may be easier to just allow all domains.

Woot! OK, one more step. When using PouchDB and sync, they expect you to supply a connection URL. You can get this back in your Bluemix console. Select the “Show Credentials” link to expand the connection data and then copy the “url” portion.

And voila – that’s it. If you open your test in multiple browsers, you’ll see everything sync perfectly. Remember you can also use PouchDB in Node.js, which, coincidentally, you can also host up on Bluemix, so yeah, that works out well too.

Add Comment
One Comment

Leave a Reply

Your email address will not be published.Required fields are marked *


Thanks for the post! I wonder how can I create database per user for todos, since I don’t want people access to each other’s todos.

More How-tos Stories

Connect native Android app to Watson Sentiment Analysis in under 10 minutes

This blog post describes how you can add Watson's cognitive service to an Android app in about 10 minutes.

Continue reading

Best of Bluemix: Elastic apps, iOS8 games, and 5 advantages for developers

This weekly post showcases some of the best new tutorials, videos, and other content published each week on developerWorks. Featured are articles on creating an iOS 8 game, an introduction to Bluemix fundamentals, and making your application "elastic" on Bluemix. More...

Continue reading

Using Watson services with Google Docs

I recently worked with a client on an experimental approach for natural language analysis of responses to interview questions. We wanted to see if Watson could automatically report concepts and tone from the interview responses. My first test case and results are somewhat raw, but they showed me how easily I could use Watson and Google Sheets to analyze text and share the results.

Continue reading