Please use the form below to provide your feedback. Because your feedback is valuable to us, the information you submit in this form is recorded in our issue tracking system (JIRA), which is publicly available. You can track the status of your feedback using the ticket number displayed in the dialog once you submit the form.

Full Installation of the C++ SDK

      +
      Installation instructions for the Couchbase C++ Client.

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

      Prerequisites

      A C++ 17 compiler and CMake version 3.19 or newer is required. See the Compatibility section for details on supported platforms.

      Installing the SDK

      With CPM.cmake

      CPM.cmake makes it really easy to include the library in your project. You only need to include the following command in your CMakeLists.txt.

      CPMAddPackage(
  NAME
  couchbase_cxx_client
  GIT_TAG
  1.0.3
  VERSION
  1.0.3
  GITHUB_REPOSITORY
  "couchbase/couchbase-cxx-client"
  OPTIONS
  "COUCHBASE_CXX_CLIENT_STATIC_BORINGSSL ON")

      Building from source

      Full instructions to build the SDK from source are given in the README of our GitHub repository.

      Install on RPM-based Systems

      First, check how the platform identifies itself

      $ rpm -E '%dist/%_arch' | sed 's/^\.//'

      This command would print the distribution/architecture part of the .repo URL. For example, for AmazonLinux 2023 on ARM architecture it prints the following:

      $ rpm -E '%dist/%_arch' | sed 's/^\.//'
amzn2023/aarch64

      Now use this string to download repository URL:

      DIST_ARCH=$(rpm -E '%dist/%_arch' | sed 's/^\.//')
REPO_URL="https://packages.couchbase.com/clients/cxx/repos/rpm/${DIST_ARCH}/couchbase-cxx-client.repo"
curl -L -o/etc/yum.repos.d/couchbase-cxx-client.repo $REPO_URL

      To list all the packages provided by the repository run this command:

      $ dnf list --available --disablerepo=* --enablerepo=couchbase
Available Packages
couchbase-cxx-client.aarch64                     1.0.3-1.amzn2023      couchbase
couchbase-cxx-client.src                         1.0.3-1.amzn2023      couchbase
couchbase-cxx-client-debuginfo.aarch64           1.0.3-1.amzn2023      couchbase
couchbase-cxx-client-debugsource.aarch64         1.0.3-1.amzn2023      couchbase
couchbase-cxx-client-devel.aarch64               1.0.3-1.amzn2023      couchbase
couchbase-cxx-client-tools.aarch64               1.0.3-1.amzn2023      couchbase
couchbase-cxx-client-tools-debuginfo.aarch64     1.0.3-1.amzn2023      couchbase

      To install the library with the headers:

      dnf install couchbase-cxx-client couchbase-cxx-client-devel

      To install the command line tools:

      dnf install couchbase-cxx-client-tools

      Currently supported platforms are aarch64 and x86_64 for the following distributions: