Connect To Your Cluster

  • Capella Operational
  • how-to
December 15, 2024
+ 12
Use the Connect page to choose how you want to connect to your cluster.

This page covers connecting to your cluster from:

Prerequisites

The procedures on this page assume the following:

  • You have configured cluster access by creating a cluster access credential. You’ll need the username and password for the cluster credential to connect to the cluster.

  • You have added your IP address to the cluster’s list of allowed IPs.

  • You have downloaded the security certificate for your cluster.

  • You’re not connecting from an IPv6-only environment — you need to be able to use the IPv4 records published for Capella clusters.

You can do all of this from a single location using the Connect page in the Capella UI.

Connect from SDK, cbsh, CLI, or IDE

Follow these steps to connect from an SDK, Couchbase Shell, the command line tools, or an IDE plugin or extension:

The Connect page in the Capella UI provides the details to connect to your cluster with an application using an SDK.

From the Capella UI:

  1. On the Operational Clusters page, click on the cluster that you want to connect to.

  2. Go to Connect  SDK.

  3. Note the public connection string — you’ll need this to connect to the cluster.

  4. If you have not already done so, follow the instructions on screen to enter an allowed IP address.

  5. Choose an existing cluster user from the drop-down, or create a new cluster access user.

  6. Select the preferred SDK language.

  7. Now install the SDK for the language that you have chosen, following the instructions in the linked SDK docs.

  8. To get started with your chosen SDK, choose a snippet or the full code sample.

    • Select Snippet to generate the connection code snippet for the chosen language, pre-populated with the connection string and user name. Replace <<password>> with the password you specified when you created the cluster access user.

    • Select Full Code Sample to display a full code sample for your chosen language. You can customize the code sample by choosing the bucket, scope, and collection the cluster user has access to — although some fields will be pre-populated already, such as the connection string and username.

You can find documentation and troubleshooting reference materials within the Connect  SDK screen.

The SDK Compatibility page lists the minimum supported SDK versions. Couchbase recommends using the latest version of your chosen SDK, as it contains bug fixes and feature enhancements.

Troubleshooting

Working across networks adds an extra layer of complexity. See the troubleshooting documentation if you have problems making a connection.

Next Steps