The Couchbase Ruby SDK allows you to connect to a Couchbase cluster from Ruby. The Ruby SDK includes high-performance native Ruby extensions to handle communicating to the cluster over Couchbase’s binary protocols.

puts "\n==== Beer by strength (out of #{res.facets['by_strength'].total}):"
res.facets["by_strength"].numeric_ranges.each_with_index do |range, idx|
  puts "#{idx}. #{}, ABV: [#{range.min}..#{range.max}] (#{range.count} records)"

Couchbase Ruby SDK 3.2

Getting Started

Dive right in with a quick install and Hello World. Try out our Travel Sample Application. And take a look at the Collections feature.

Practical Howto Docs

Connect to our services — data (KV); Query; Search; Analytics; Views — and the Sub-Document API.

Reference Guides

The documentation supplements the practical Howto docs with references and concept guides, for those who prefer a broader understanding before diving in and coding.

What’s Hot?

Leverage the new Couchbase Server Scopes and Collection features to build multi-tenant micro-service application.


Those useful nuts-and-bolts guides to compatibility tables; release notes; and the contribution guide.


For community help, visit the Couchbase forums. The Ruby SDK can be combined with many other projects in the broader Ruby ecosystem and beyond.