A newer version of this documentation is available.

View Latest

Couchbase Java SDK Installation

      +
      Installation instructions for the Couchbase Java Client.

      The Couchbase Java SDK allows Java applications to access a Couchbase cluster. It offers synchronous APIs as well as reactive and asynchronous equivalents to maximize flexibility and performance.

      The Couchbase Java SDK 3.x is a complete rewrite of the 2.x API, providing a simpler surface area and adding support for Couchbase Server features like Collections and Scopes (available in Couchbase Server 7.0). The (reactive) API also migrated from RxJava to Reactor, along with other improvements to performance, logging, debugging and timeout troubleshooting. If you’re upgrading your application from Java SDK 2.x, please read our Migrating 2.x code to SDK 3.0 Guide.

      Prerequisites

      The Java SDK is tested against LTS versions of Oracle JDK and OpenJDK — see our compatibility docs. The underlying OS normally makes no difference, but library incompatibilities in Alpine Linux makes a workaround necessary for this OS.

      Installing the SDK

      At least Java 8 is required for current releases; see the Compatibility section for details. We recommend running the latest Java LTS version (i.e. at the time of writing JDK 17) with the highest patch version available. Java 17 has various enhancements like sealed classes, pattern matching for switch expressions (in preview), and further updates and improvements on core libraries.

      Couchbase publishes all stable artifacts to Maven Central. The latest version (as of September 2022) is 3.3.4.

      You can use your favorite dependency management tool to install the SDK.

      • Maven

      • Gradle

      The following snippet shows how to do it with Maven.

      <dependencies>
          <dependency>
              <groupId>com.couchbase.client</groupId>
              <artifactId>java-client</artifactId>
              <version>3.3.4</version>
          </dependency>
      </dependencies>

      For Gradle, you can use:

      implementation 'com.couchbase.client:java-client:3.3.4'

      Alternatively, we provide a zip file with all the dependencies bundled if you wish to manually include the jar files in your classpath. Refer to the Release Notes for further details. You can also find links to the hosted javadocs there.