---
title: Stream Data from Couchbase Server
pubDate: 2026-10-19T14:21:08.937Z
meta:
  component:
    title: Operational Insights Enterprise
    version: "3.0"
  topic_type: guide
antora:
  editUrl: https://github.com/couchbaselabs/docs-enterprise-analytics/edit/release/3.0/modules/sources/pages/remote-cb-server.adoc
  xref: xref:enterprise-analytics:sources:remote-cb-server.adoc[]
---

[Consult the llms.txt file for a full list of contents](/llms.txt)
[View original HTML](/operational-insights/current/sources/remote-cb-server.html)

# Stream Data from Couchbase Server

> To continuously update an Operational Insights collection with data hosted on Couchbase Server, create a remote link and collection. 

> [!TIP]
> For an example, see [Create Remote Collections for beer-sample](../intro/connecting-to-data-sources.md#create-remote-collections-for-beer-sample).

## [](#encryption)Requirements

Your Operational Insights account must have the `**Operational Insights Access**` role along with specific privileges to be able to create a link and its associated collection.

You need to take the following steps on your Couchbase Server cluster:

1. Configure your Couchbase Server cluster's network to allow access from Operational Insights. The steps you must take depend on how and where you deployed your Couchbase Server cluster. For example, suppose you deployed a self-managed Couchbase Server in AWS. To allow Operational Insights to connect, create a VPC peering connection between the VPCs for your Operational Insights and the Couchbase Server cluster.
2. Create a user and password for Operational Insights to use when connecting. Give this user read permissions for all buckets and scopes you want to stream. See [Manage Users, Groups, and Roles](../../../server/current/manage/manage-security/manage-users-and-roles.md).
3. Get the hostname or external IP address for 1 of the Couchbase Server nodes. You supply this value to Operational Insights as the connection string.
4. Save a copy of the Couchbase Server's cluster certificate. You can get the certificate from 2 places:

  * Copy the certificate from the Couchbase Server Web Console's **Security** **Certificate** page under the **Trusted Root Certificate**.
  * Get the certificate by calling Couchbase Server's [/pools/default/trustedCAs REST API](../../../server/current/rest-api/get-trusted-cas.md).
5. Note the names of the bucket, scope, and collection you want to stream to Operational Insights.

## [](#link)Create a Link to a Couchbase Server

1. In the UI, select the **Workbench** tab.
2. Select **\+ new link**.
3. In the **Link Name** field, enter a name for the link.
4. In the **Link Type** field, select **Couchbase**.
5. In the **Remote IP/Hostname** list, select the hostname or IP address of a node in the remote cluster you want to link. IPv6 addresses need to be enclosed in square brackets.
6. In the **Encryption Type** field, select 1 of the following options:

  * None (password is not secured)
  * Half (secure password with SCRAM-SHA)
  * Full (using credentials)
  * Full (using client certificate(s))
  * Full (using encrypted client certificate password)

| **Remote Username** | Enter the required username. |
| ------------------- | ---------------------------- |
| **Remote Password** | Enter the required password. |

| **Remote Username** | Enter the required username. |
| ------------------- | ---------------------------- |
| **Remote Password** | Enter the required password. |

| **Remote Username**               | Enter the required username.      |
| --------------------------------- | --------------------------------- |
| **Remote Password**               | Enter the required password.      |
| **Remote Cluster Certifcates(s)** | Paste a trusted root certificate. |

| **Remote Cluster Certificate(s)** | Paste a trusted root certificate.                                      |
| --------------------------------- | ---------------------------------------------------------------------- |
| **Client Certificate**            | Paste the certificate used to identify the user on the remote cluster. |
| **Client Key**                    | Paste the private key for the above client certificate.                |

| **Remote Cluster Certificate(s)** | Paste a trusted root certificate.                                      |
| --------------------------------- | ---------------------------------------------------------------------- |
| **Client Certificate**            | Paste the certificate used to identify the user on the remote cluster. |
| **Encrypted Client Key**          | Paste the encrypted private key for the above client certificate.      |
| **Passphrase Type**               | Select **Plain** or **REST**.                                          |
| **Password**                      | Select a password.                                                     |  
For more information, see [Load Root Certificates](../../../server/current/rest-api/load-trusted-cas.md).
7. Select **Prevents Redirects** to prevent HTTP connections for the remote link.
8. Click **Save**.

You can now create a collection associated with the link.

## [](#create-a-collection-for-data-streamed-from-couchbase-server)Create a Collection for Data Streamed from Couchbase Server

Once you have created a link, create a collection to receive the data from Couchbase Server:

1. In the UI, select the **Workbench** tab.
2. Next to the link you created in [Create a Link to a Couchbase Server](#link), click **\+ collection**.
3. In the **Collection Name** field, enter a name for the collection.
4. In the **Database** list, select the required database and in the **Scope** list, select the required scope or verify the supplied database and scope if you're adding it to a specific scope.
5. In the **Source bucket.scope.collection** field, select the source bucket, scope and collection.
6. In the **Where (optional)** field, you can add an optional WHERE clause to filter documents in the dataset. Make sure you do not include the WHERE keyword.
7. Click **Save**. Your collection appears under the scope in the explorer.

To create a remote collection using a `CREATE COLLECTION` statement, see [CREATE a Remote Collection](../sqlpp/5%5Fddl%5Fremote.md).

## [](#connect-the-link)Connect the Link

To have Operational Insights start streaming data from the Couchbase Server:

1. In the explorer, locate the link you want to connect.
2. Click **Link**.

## [](#see-also)See Also

* [Query and Explore with the Workbench](../query/workbench.md)
* [Connect or Disconnect a Remote Link](connect-link.md)
* [Quick Start Tutorial](../intro/connecting-to-data-sources.md)