In addition to the recent SDKs releases, I am also glad to announce the release of a newly minted Node.js SDK as well!  This new major version of the Node.js SDK introduces a number of new features and bug fixes in addition to numerous performance and maintainability changes introduced through libcouchbase 2.4.0.

Check out a breakdown of the major changes:

  1. Creating a new bucket object now happens through a new Cluster type, making it easier than ever to open connections to multiple buckets contained within the same cluster!  In addition to the usage of this new method of instantiating bucket objects, the cluster bootstrap list (list of couchbase nodes) is now replaced with a powerful and flexible uri-like format.  Here’s an example:
        var couchbase = require(‘couchbase’);
    var cluster = new couchbase.Cluster(‘couchbase://,’);
    var db1 = cluster.openBucket(‘default’);
    var db2 = cluster.openBucket(‘thatotherbucket’);
  2. Various bucket operations have been renamed to better reflect the document-oriented usage of Couchbase Server.
        db1.upsert(‘testdoc’, {name:’Frank’}, …);
  3. Support for SSL-encrypted communications with the cluster (More to come on this later).
        var couchbase = require(‘couchbase’);
    var cluster = new couchbase.Cluster(‘couchbases://,’);
    var db1 = cluster.openBucket(‘default’);

Keep in mind that all of these changes are backwards compatible with 1.x versions of the Node.js SDK, so your applications will continue to function correctly with the improved performance of the newly updated internals.  However, in order to access any of the newer features, slight alterations to your code may be required.


The documentation describing the full API is available to peruse here:

Get It

This release is published through npm as usual, however it is not tagged as a latest release, meaning you must specifically define this version when executing your npm install.  To specify this release, add "couchbase": "2.0.0-dp1" to your package.json, or execute:

npm install couchbase@2.0.0-dp1 –save

If you encounter any issues, please post directly to the Couchbase Communities site at Additionally, bugs can be reported directly through our issues tracker available here:

I hope you enjoy!

Cheers! Brett


Posted by Brett Lawson, Principal Software Engineer, Couchbase

Brett Lawson is a Principal Software Engineer at Couchbase. Brett is responsible for the design and development of the Couchbase Node.js and PHP clients as well as playing a role in the design and development of the C library, libcouchbase.


  1. Hello, I am working on a Couchbase ODM for node that uses design decisions very similar to the popular mongoose module.

    It is pretty difficult to integrate against this module when development isn\’t happening (or isn\’t happening in the open). I\’m nearly finished with what I want to accomplish in the first release, but writting tests requires a real DB since the mock module looks nothing like the actual Bucket objects.

    Is there any news on the next version of this module, or it being developed in the open so the community can contribute?


    1. Hey Chad!
      I would love to hear more about the module you are developing, we have a prototype ODM for node known as ottoman currently, which we hope to have usable soon. The Node.js 2.0.0 client is still in development, but there has been some behind-the-scenes design decisions being made in relation to the overall interface of the client, hopefully I will be turning those designs into code very soon. Please contact me on IRC, Skype or Email!
      Cheers, Brett

Leave a reply