March 16, 2025
+ 12
Installation instructions for the Couchbase Scala Client.

This page gives full installation instructions for the Scala SDK. In most cases, the Quickstart Guide should be enough to get you up and running if you’re in a hurry.

Prerequisites

The Scala 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.

The Couchbase Scala SDK 1.7 Client supports Scala 2.12 and 2.13.

Installing the SDK

The Couchbase Scala SDK is available on the Maven repository, packaged for Scala 2.12 and 2.13.

With SBT Projects

It can be included in your SBT build like this:

sbt
libraryDependencies += "com.couchbase.client" %% "scala-client" % "1.7.8"

This will automatically use the Scala 2.12 or 2.13 builds, as appropriate for your SBT project.

With Gradle Projects

It can be included in your build.gradle like this for 2.12:

groovy
dependencies { compile group: 'com.couchbase.client', name: 'scala-client_2.12', version: '1.7.8' }

or 2.13:

groovy
dependencies { compile group: 'com.couchbase.client', name: 'scala-client_2.13', version: '1.7.8' }

With Maven Projects

It can be included in your Maven pom.xml like this for 2.12:

xml
<dependencies> <dependency> <groupId>com.couchbase.client</groupId> <artifactId>scala-client_2.12</artifactId> <version>1.7.8</version> </dependency> </dependencies>

or 2.13:

xml
<dependencies> <dependency> <groupId>com.couchbase.client</groupId> <artifactId>scala-client_2.13</artifactId> <version>1.7.8</version> </dependency> </dependencies>

Using a Snapshot Version

Couchbase publishes pre-release snapshot artifacts to the Sonatype OSS Snapshot Repository. If you wish to use a snapshot version, you’ll need to tell your build tool about this repository.

pom.xml
xml
<repositories> <repository> <id>sonatype-snapshots</id> <url>https://oss.sonatype.org/content/repositories/snapshots</url> <releases><enabled>false</enabled></releases> <snapshots><enabled>true</enabled></snapshots> </repository> </repositories>

Further Reading

For those who spend little or no time using Scala, but have to evaluate the platform, further installation and background help is available on the Scala Platform Introduction page.