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.1

Getting Started

Dive right in with a quick install and Hello World.

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?

The Couchbase Ruby SDK 3.x is a complete rewrite of the API, reducing the number of overloads to present a simplified surface area, and adding support for future Couchbase Server features like Collections and Scopes (available in Couchbase Server 6.5 & 6.6 as a developer preview), and in Couchbase 7.0.


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.