{"id":13413,"date":"2024-10-16T11:11:37","date_gmt":"2024-10-16T18:11:37","guid":{"rendered":"https:\/\/www.couchbase.com\/blog\/?p=13413"},"modified":"2025-06-13T21:51:41","modified_gmt":"2025-06-14T04:51:41","slug":"how-to-migrate-from-couchbase-server-to-couchbase-capella","status":"publish","type":"post","link":"https:\/\/www.couchbase.com\/blog\/how-to-migrate-from-couchbase-server-to-couchbase-capella\/","title":{"rendered":"How To Migrate From Couchbase Server to Couchbase Capella"},"content":{"rendered":"<p><strong>Steps to migrate self-managed Couchbase Server clusters to Couchbase Capella\u2122 Database-as-a-Service (DBaaS)<\/strong><\/p>\n<p><a href=\"https:\/\/www.couchbase.com\/products\/capella\/start-today?utm_source=google&amp;utm_medium=search&amp;utm_campaign=GGL+-+North+America+-+US%2FCA+-+Cloud+-+Brand&amp;utm_keyword=couchbase%20capella&amp;kpid=go_cmp-14963773353_adg-137104722708_ad-553533476351_kwd-1437680313279_dev-c_ext-_prd-&amp;gclid=CjwKCAjw6dmSBhBkEiwA_W-EoLQUEzKI1ocFHh-gw71wEBrTqIZ9SszuFnh7HswUYVGwHbtQbPSXWhoCUoAQAvD_BwE\" target=\"_blank\" rel=\"noopener\"><span style=\"font-weight: 400;\">Couchbase Capella<\/span><\/a><span style=\"font-weight: 400;\"> is the easiest and fastest way to begin with Couchbase. This fully managed Database-as-a-Service eliminates your database management efforts and reduces costs while delivering flexibility across all use cases with built-in multi-model capabilities. Its memory-first architecture drives high speed data response at scale, resulting in the best price-performance of any fully managed document database.<\/span><\/p>\n<h2>Why migrate?<\/h2>\n<p><span style=\"font-weight: 400;\">If you\u2019re running a self-managed Couchbase Server implementation, you and your team are probably responsible for handling database maintenance tasks that take time away from developing your applications. As a managed service, Couchbase Capella removes the need to take care of installations, upgrades and general database maintenance \u2013 it\u2019s all handled for you. And for those of you using the Community Edition of Couchbase Server, Couchbase Capella can provide a fast and easy way to level up your database with more nodes and Enterprise features. Couchbase Capella supports all Couchbase Server services and capabilities.<\/span><\/p>\n<p><span style=\"font-weight: 400;\">This blog provides steps for migrating data and indexes from your Couchbase Server clusters, running either on premises or in the cloud, to Couchbase Capella.<\/span><\/p>\n<h3>Prerequisites<b>\u00a0<\/b><\/h3>\n<ul>\n<li style=\"list-style-type: none;\">\n<ul>\n<li style=\"font-weight: 400;\"><span style=\"font-weight: 400;\">An existing Couchbase Capella account. You can create and use Couchbase Capella for free, <a href=\"https:\/\/cloud.couchbase.com\/sign-up?ref=blog\">just sign up here<\/a><br \/>\n<\/span><\/p>\n<ul>\n<li style=\"font-weight: 400;\"><span style=\"font-weight: 400;\">Follow the instructions in the <\/span><a href=\"https:\/\/docs.couchbase.com\/tutorials\/dbaas-self-service\/index.html\" target=\"_blank\" rel=\"noopener\"><span style=\"font-weight: 400;\">Getting Started with Couchbase Capella<\/span><\/a><span style=\"font-weight: 400;\"> tutorial to get started<\/span><\/li>\n<li>Note: <span style=\"font-weight: 400;\">The self-service free tier version is restricted to a single node and 10GB of data &#8211; for more information refer to <\/span><a href=\"https:\/\/docs.couchbase.com\/cloud\/get-started\/create-account.html\" target=\"_blank\" rel=\"noopener\"><span style=\"font-weight: 400;\">Capella documentation<\/span><\/a><\/li>\n<\/ul>\n<\/li>\n<li style=\"font-weight: 400;\"><span style=\"font-weight: 400;\">An existing self-managed Couchbase Server environment either on premises or deployed on a cloud service provider<\/span><\/li>\n<li>It is assumed that you already have:\n<ul>\n<li><span style=\"font-weight: 400;\">Familiarity with administering Couchbase Server and Couchbase Capella<\/span><\/li>\n<li><span style=\"font-weight: 400;\">Familiarity with running commands in a command line interface (CLI)<\/span><\/li>\n<\/ul>\n<\/li>\n<\/ul>\n<\/li>\n<\/ul>\n<h3>Limitations<\/h3>\n<p><span style=\"font-weight: 400;\">This guide is used to migrate data and secondary indexes from Couchbase Server to Couchbase Capella. The guide does not apply to migrating the <\/span><a href=\"https:\/\/docs.couchbase.com\/server\/current\/eventing\/eventing-overview.html\" target=\"_blank\" rel=\"noopener\"><span style=\"font-weight: 400;\">Couchbase Eventing Service<\/span><\/a><span style=\"font-weight: 400;\">, <\/span><a href=\"https:\/\/docs.couchbase.com\/server\/current\/fts\/fts-introduction.html\" target=\"_blank\" rel=\"noopener\"><span style=\"font-weight: 400;\">Couchbase Full-Text Search<\/span><\/a><span style=\"font-weight: 400;\"> (FTS) indexes or <\/span><a href=\"https:\/\/docs.couchbase.com\/server\/current\/analytics\/introduction.html\" target=\"_blank\" rel=\"noopener\"><span style=\"font-weight: 400;\">Couchbase Analytics<\/span><\/a><span style=\"font-weight: 400;\">.<\/span><\/p>\n<p>Versions of Couchbase supported by this guide include Couchbase Server (Community Edition or Enterprise Edition) versions 6.6, 7.0.x, 7.1, and newer.<\/p>\n<h3>Utilities<\/h3>\n<ul>\n<li style=\"list-style-type: none;\">\n<ul>\n<li style=\"font-weight: 400;\"><a href=\"https:\/\/docs.couchbase.com\/server\/current\/backup-restore\/enterprise-backup-restore.html\" target=\"_blank\" rel=\"noopener\"><span style=\"font-weight: 400;\">Couchbase cbbackupmgr<\/span><\/a><span style=\"font-weight: 400;\"> &#8211; is a Command Line Interface (CLI) tool for managing the backup and restore of Couchbase Server data. It is used for migrating data and indexes from the following versions of self-managed Couchbase Server to Capella:<\/span>\n<ul>\n<li style=\"font-weight: 400;\"><span style=\"font-weight: 400;\">Enterprise Edition version 6.6, version 7.x<\/span><\/li>\n<li style=\"font-weight: 400;\"><span style=\"font-weight: 400;\">Community Edition version 7.x<\/span><\/li>\n<li style=\"font-weight: 400;\"><span style=\"font-weight: 400;\">Steps for using cbbackupmgr for migration are detailed in the section of this guide titled <strong>Migrate using cbbackupmgr &#8211; option 1<\/strong><\/span><\/li>\n<\/ul>\n<\/li>\n<li style=\"font-weight: 400;\"><a href=\"https:\/\/docs.couchbase.com\/server\/current\/cli\/cbtools\/cbbackup.html\" target=\"_blank\" rel=\"noopener\"><span style=\"font-weight: 400;\">Couchbase cbbackup<\/span><\/a><span style=\"font-weight: 400;\"> and <\/span><a href=\"https:\/\/docs.couchbase.com\/server\/current\/cli\/cbtools\/cbrestore.html\" target=\"_blank\" rel=\"noopener\"><span style=\"font-weight: 400;\">cbrestore<\/span><\/a><span style=\"font-weight: 400;\"> &#8211; are CLI tools used for migrating data from the following version of self-managed Couchbase Server to Capella:<\/span>\n<ul>\n<li style=\"font-weight: 400;\"><span style=\"font-weight: 400;\">Community Edition version 6.6<\/span><\/li>\n<li style=\"font-weight: 400;\"><span style=\"font-weight: 400;\">Steps for using cbbackup and cbrestore for migration are detailed in the section of this guide titled <strong>Migrate using cbbackup and cbrestore &#8211; option 2<\/strong><\/span><\/li>\n<\/ul>\n<\/li>\n<li style=\"font-weight: 400;\"><a href=\"https:\/\/docs.couchbase.com\/cloud\/current\/clusters\/xdcr\/xdcr.html\" target=\"_blank\" rel=\"noopener\"><span style=\"font-weight: 400;\">Couchbase XDCR<\/span><\/a><span style=\"font-weight: 400;\"> \u2013 Couchbase cross data center replication (XDCR) allows data to be replicated across clusters. It is used in this guide for ongoing migration from self-managed Couchbase Server clusters to Capella clusters<\/span><\/li>\n<\/ul>\n<\/li>\n<\/ul>\n<p><b>Note:\u00a0<\/b><span style=\"font-weight: 400;\">XDCR cannot be used with Couchbase Server Community Edition or Capella Free Tier<\/span><\/p>\n<hr \/>\n<p><span style=\"font-weight: 400;\">The <\/span><b>Prepare for migrating<\/b><span style=\"font-weight: 400;\">\u00a0section of this document provides general guidance for assessing the size of your self-managed Couchbase Server cluster and using it to identify the required configurations for your Couchbase Capella cluster. For help with a more detailed Couchbase Capella sizing exercise, please <\/span><a href=\"https:\/\/www.couchbase.com\/contact\/\" target=\"_blank\" rel=\"noopener\"><span style=\"font-weight: 400;\">contact Couchbase<\/span><\/a><span style=\"font-weight: 400;\">.<\/span><\/p>\n<hr \/>\n<h2>Prepare for migrating<\/h2>\n<p><span style=\"font-weight: 400;\">If you are using the Couchbase Capella free tier, you can migrate data following this guide, but you will not be able to deploy a multi-node Capella environment due to configuration restrictions in the free tier. We recommend converting the free tier to a <a href=\"https:\/\/www.couchbase.com\/pricing\/\">paid account<\/a> before beginning a migration in order to configure a full multi-node deployment. To convert your account, open the <\/span><b>Billing<\/b><span style=\"font-weight: 400;\"> section of the Couchbase Capella UI and then choose <\/span><b>Add Activation ID<\/b><span style=\"font-weight: 400;\">.<\/span><\/p>\n<p><b><i>Review your self-managed Couchbase Server cluster:<\/i><\/b><\/p>\n<ul>\n<li style=\"list-style-type: none;\">\n<ul>\n<li><span style=\"font-weight: 400;\">Log in to your self-managed <\/span><a href=\"https:\/\/docs.couchbase.com\/server\/current\/manage\/manage-ui\/manage-ui.html\" target=\"_blank\" rel=\"noopener\"><span style=\"font-weight: 400;\">Couchbase Server Web Console<\/span><\/a><span style=\"font-weight: 400;\"> and assess your cluster\u2019s nodes and buckets<\/span><\/li>\n<li><span style=\"font-weight: 400;\">Choose the <strong>Servers<\/strong> tab in the main navigation to show a list of cluster nodes. Record the number of nodes and then choose each node on the list to display its properties<\/span><\/li>\n<li><span style=\"font-weight: 400;\">Record the memory and storage for each individual node<\/span><\/li>\n<li><span style=\"font-weight: 400;\">Choose the <strong>Buckets<\/strong> tab in the main navigation and then choose each bucket in the list to display its properties<\/span><\/li>\n<li><span style=\"font-weight: 400;\">Record the RAM quota and conflict resolution setting for each bucket<\/span><\/li>\n<li><span style=\"font-weight: 400;\">You will use your self-managed Couchbase Server cluster configurations as a general guide for sizing and configuring the destination cluster on Couchbase Capella<\/span><\/li>\n<\/ul>\n<\/li>\n<\/ul>\n<p><span style=\"font-weight: 400;\">You do not need to duplicate the exact cluster configuration on Capella. This is especially true if you are using Capella Free Tier that comes with a fixed configuration.<\/span><\/p>\n<p><b><i>Note the Couchbase Service distribution on the self-managed Couchbase Server cluster:<\/i><\/b><\/p>\n<ul>\n<li style=\"list-style-type: none;\">\n<ul>\n<li><span style=\"font-weight: 400;\">In the Couchbase Server Web Console, choose the <strong>Servers<\/strong> tab in the main navigation to display the list of cluster nodes<\/span><\/li>\n<li><span style=\"font-weight: 400;\">Click each node in the list to display its properties and then record the Couchbase Service distribution for each node (<\/span><a href=\"https:\/\/docs.couchbase.com\/server\/current\/learn\/services-and-indexes\/services\/data-service.html\"><span style=\"font-weight: 400;\">Data Service<\/span><\/a><span style=\"font-weight: 400;\">, <\/span><a href=\"https:\/\/docs.couchbase.com\/server\/current\/learn\/services-and-indexes\/services\/query-service.html\"><span style=\"font-weight: 400;\">Query Service<\/span><\/a><span style=\"font-weight: 400;\">, <\/span><a href=\"https:\/\/docs.couchbase.com\/server\/current\/learn\/services-and-indexes\/services\/index-service.html\"><span style=\"font-weight: 400;\">Index Service<\/span><\/a><span style=\"font-weight: 400;\">, <\/span><a href=\"https:\/\/docs.couchbase.com\/server\/current\/learn\/services-and-indexes\/services\/search-service.html\"><span style=\"font-weight: 400;\">Search Service<\/span><\/a><span style=\"font-weight: 400;\">, <\/span><a href=\"https:\/\/docs.couchbase.com\/server\/current\/learn\/services-and-indexes\/services\/analytics-service.html\"><span style=\"font-weight: 400;\">Analytics Service<\/span><\/a><span style=\"font-weight: 400;\">, and <\/span><a href=\"https:\/\/docs.couchbase.com\/server\/current\/learn\/services-and-indexes\/services\/eventing-service.html\"><span style=\"font-weight: 400;\">Eventing Service<\/span><\/a><span style=\"font-weight: 400;\">)<\/span><\/li>\n<\/ul>\n<\/li>\n<\/ul>\n<p><b><i>Record the IP addresses of the self-managed Couchbase Server cluster nodes:<\/i><\/b><\/p>\n<p><i>Skip this step if you are using Community Edition<\/i><\/p>\n<ul>\n<li style=\"list-style-type: none;\">\n<ul>\n<li><span style=\"font-weight: 400;\">Record the IP address for each node in your cluster, this is for whitelisting them on your Couchbase Capella cluster later.<\/span><\/li>\n<li><i><span style=\"font-weight: 400;\">TIP<\/span><\/i><span style=\"font-weight: 400;\">: To get the IP of each node in your self managed cluster:<\/span>\n<ul>\n<li style=\"font-weight: 400;\"><span style=\"font-weight: 400;\">SSH into the node<\/span><\/li>\n<li style=\"font-weight: 400;\"><span style=\"font-weight: 400;\">Issue this command: <\/span><em><span style=\"font-weight: 400;\"><code>dig +short myip.opendns.com @resolver1.opendns.com<\/code><\/span><\/em><\/li>\n<\/ul>\n<\/li>\n<\/ul>\n<\/li>\n<\/ul>\n<h2>Deploy and configure a cluster on Couchbase Capella<\/h2>\n<p><i><\/i><b><i>Create and configure a cluster on Couchbase Capella:<\/i><\/b><\/p>\n<ul>\n<li style=\"list-style-type: none;\">\n<ul>\n<li><span style=\"font-weight: 400;\">Log in to the Couchbase Capella UI, choose the <strong>Clusters<\/strong> tab in the main navigation menu and then choose <strong>Create Cluster<\/strong>. (In the free tier, you should already have a cluster created for you, and you cannot further customize the sizing)<\/span><\/li>\n<li><span style=\"font-weight: 400;\">Use the information that you recorded from the review of your self-managed Couchbase Server cluster and choose the cluster template that meets the configuration\u2019s requirements<\/span><\/li>\n<li><span style=\"font-weight: 400;\">If you don\u2019t find an appropriate template, choose <strong>Custom Template<\/strong> in the <strong>Cluster Sizing<\/strong> editor<\/span><\/li>\n<li><span style=\"font-weight: 400;\">Choose and configure the nodes to match your self-managed Couchbase Server cluster environment, including number of nodes, services distribution, compute or RAM, and storage<\/span><\/li>\n<li><span style=\"font-weight: 400;\">Choose a support zone and support package, and then deploy the cluster. For detailed steps and instructions on creating a cluster, see <\/span><a href=\"https:\/\/docs.couchbase.com\/cloud\/clusters\/create-cluster.html\"><span style=\"font-weight: 400;\">Create a cluster<\/span><\/a><span style=\"font-weight: 400;\"> in the Couchbase Capella documentation<\/span><\/li>\n<\/ul>\n<\/li>\n<\/ul>\n<p><span style=\"font-weight: 400;\">Couchbase Capella uses <\/span><a href=\"https:\/\/docs.couchbase.com\/cloud\/clusters\/scale-cluster.html#scale-a-cluster\"><span style=\"font-weight: 400;\">multi-dimensional scaling<\/span><\/a><span style=\"font-weight: 400;\"> guidelines, and services and nodes can only be chosen according to deployment guidelines.<\/span><\/p>\n<p><b><i>Create a database credentials user:<\/i><\/b><\/p>\n<ul>\n<li style=\"list-style-type: none;\">\n<ul>\n<li><span style=\"font-weight: 400;\">A database credentials user is specific to a cluster, and consists of a username, password, and a set of bucket privileges. This user is required for accessing bucket data<\/span><\/li>\n<li><span style=\"font-weight: 400;\">In the Couchbase Capella UI, create a database credential user for the new cluster by following the instructions in <\/span><a href=\"https:\/\/docs.couchbase.com\/cloud\/security\/manage-database-users.html\"><span style=\"font-weight: 400;\">Configure database credentials<\/span><\/a><span style=\"font-weight: 400;\"> from the Couchbase Capella documentation<\/span><\/li>\n<\/ul>\n<\/li>\n<\/ul>\n<p><b><i>Record Couchbase Capella cluster connection endpoint and add IP address as \u201cAllowed IP\u201d.<\/i><\/b><\/p>\n<p><b><i>Save Root Certificates for self-managed Couchbase Server and Couchbase Capella:<\/i><\/b><\/p>\n<ul>\n<li style=\"list-style-type: none;\">\n<ul>\n<li><span style=\"font-weight: 400;\">In the Couchbase Capella UI, choose <strong>Clusters<\/strong>, and then choose your destination cluster. Choose the <strong>Connect<\/strong> tab for the cluster and record the connection endpoint for your cluster under <strong>Wide Area Network<\/strong>.<\/span><\/li>\n<li style=\"font-weight: 400;\"><span style=\"font-weight: 400;\">NOTE: If your self-managed Couchbase Server is running version 7.0.x, you will need to copy the hostname URL for a DATA SERVICE NODE instead of the Wide Area Network endpoint.<\/span><\/li>\n<li style=\"font-weight: 400;\"><span style=\"font-weight: 400;\">In the Couchbase Capella UI, choose the <strong>Nodes<\/strong>\u00a0tab for the destination cluster, all nodes in your cluster will be listed. Choose one of the nodes that is running the DATA SERVICE, and record the HOSTNAME for the node.<\/span><\/li>\n<\/ul>\n<\/li>\n<\/ul>\n<p><span style=\"font-weight: 400;\">Add the IP address of the system where you will run the command line tools for migrating data as an Allowed IP. Under <em>Wide Area Network<\/em>, click <strong>Manage Allowed IP,<\/strong> then click <strong>Add Allowed IP<\/strong>. Enter the IP address and click <strong>Add IP<\/strong>. For more information about allowed IPs, see <\/span><a href=\"https:\/\/docs.couchbase.com\/cloud\/security\/allow-ip-address.html\"><span style=\"font-weight: 400;\">Configure allowed IP addresses<\/span><\/a><span style=\"font-weight: 400;\"> in the Couchbase documentation.<\/span><\/p>\n<p><b>Note:<\/b><span style=\"font-weight: 400;\"> If adding an allowed IP fails, in most cases it is related to firewall issues. <a href=\"https:\/\/docs.couchbase.com\/server\/current\/install\/install-ports.html\">See Couchbase documentation<\/a> for information on the default ports used by Couchbase Server.<\/span><\/p>\n<p><span style=\"font-weight: 400;\">Download the root certificate for your Capella cluster. Under <em>Root Certificate,<\/em> click <strong>Download<\/strong>. Save the root certificate as a <em>.pem<\/em> file extension in a folder on the system that will run Couchbase CLI tools.<\/span><\/p>\n<p><span style=\"font-weight: 400;\">Next, log in to your self-managed Couchbase Server Web Console. Copy the root certificate for your self-managed Couchbase Server cluster and save it as a <em>.pem<\/em> file to the same folder where you saved the root certificate file for your Couchbase Capella cluster. For more information about the root certificate, see <\/span><a href=\"https:\/\/docs.couchbase.com\/server\/current\/manage\/manage-security\/manage-security-settings.html#root-certificate-security-screen-display\"><span style=\"font-weight: 400;\">Root certificate<\/span><\/a><span style=\"font-weight: 400;\"> in the Couchbase Server documentation.<\/span><\/p>\n<p><b><i>Create target buckets on Couchbase Capella:<\/i><\/b><\/p>\n<ul>\n<li style=\"list-style-type: none;\">\n<ul>\n<li><span style=\"font-weight: 400;\">Log in to the Couchbase Capella UI<\/span><\/li>\n<li><span style=\"font-weight: 400;\">Create one target bucket in your Couchbase Capella cluster for each source bucket by following the instructions from <\/span><a href=\"https:\/\/docs.couchbase.com\/cloud\/clusters\/data-service\/manage-buckets.html#add-bucket\"><span style=\"font-weight: 400;\">Create a bucket<\/span><\/a><span style=\"font-weight: 400;\"> in the Couchbase Capella documentation<\/span><\/li>\n<\/ul>\n<\/li>\n<\/ul>\n<p><b>Important:<\/b><span style=\"font-weight: 400;\"> Bucket names cannot contain an underscore.<\/span><\/p>\n<h2>Migrate using cbbackupmgr &#8211; option 1<\/h2>\n<p><b>This option applies to the following versions of self-managed Couchbase Server:<\/b><\/p>\n<ul>\n<li style=\"list-style-type: none;\">\n<ul>\n<li style=\"font-weight: 400;\"><span style=\"font-weight: 400;\">Enterprise Edition version 6.6, version 7.0.x, version 7.1<\/span><\/li>\n<li style=\"font-weight: 400;\"><span style=\"font-weight: 400;\">Community Edition version 7.0.x, version 7.1<\/span><\/li>\n<\/ul>\n<\/li>\n<\/ul>\n<p><b><i>Use cbbackupmgr CLI tool:<\/i><\/b><\/p>\n<ul>\n<li style=\"list-style-type: none;\">\n<ul>\n<li><span style=\"font-weight: 400;\"><em>cbbackupmgr<\/em> is located in the root directory of your self-managed Couchbase Server installation.<\/span><\/li>\n<li><span style=\"font-weight: 400;\">You use a command line terminal to work with cbbackupmgr.<\/span><\/li>\n<\/ul>\n<\/li>\n<\/ul>\n<p><span style=\"font-weight: 400;\">Depending on the platform, cbbackupmgr is installed with Couchbase Server in the following location:<\/span><\/p>\n<ul>\n<li style=\"list-style-type: none;\">\n<ul>\n<li><strong>Linux: <\/strong><em><span style=\"font-weight: 400;\">\/opt\/couchbase\/bin\/cbbackupmgr<\/span><\/em><\/li>\n<li><strong>Windows<\/strong> (assuming default installation):\u00a0<i>C:\\Program Files\\Couchbase\\Server\\bin\\cbbackupmgr<\/i><\/li>\n<li><strong>Mac OS X: <\/strong>\/Applications\/Couchbase <i>Server.app\/Contents\/Resources\/couchbase-core\/bin\/cbbackupmgr<\/i><\/li>\n<\/ul>\n<\/li>\n<\/ul>\n<p><strong><i>TIP<\/i><\/strong><span style=\"font-weight: 400;\">: If you do not have direct access to the install directory for Couchbase Server, you can get the cbbackupmgr command line utility by <\/span><a href=\"https:\/\/www.couchbase.com\/downloads\/\"><span style=\"font-weight: 400;\">downloading Couchbase Server<\/span><\/a><span style=\"font-weight: 400;\"> and installing it on your local system.<\/span><\/p>\n<h3>Create a backup repository on the self-managed Couchbase Server system<\/h3>\n<ul>\n<li style=\"list-style-type: none;\">\n<ul>\n<li><span style=\"font-weight: 400;\">In the command line terminal, create a directory to serve as a repository for local backups from the self-managed Couchbase Server. The following command examples use Linux syntax, adjust accordingly for your command line terminal and platform<\/span><\/li>\n<li><span style=\"font-weight: 400;\">The following command will create the directory in your systems root folder: <\/span><em><span style=\"font-weight: 400;\"><code>mkdir \/backups\/<\/code><\/span><\/em><\/li>\n<li><span style=\"font-weight: 400;\">Run the following cbbackupmgr command to create a repository in the new directory, replacing <\/span><span style=\"font-weight: 400;\"><code>&lt;SELF-MANAGED-BUCKET-NAME&gt;<\/code><\/span><span style=\"font-weight: 400;\"><span style=\"font-weight: 400;\">\u00a0with the actual name of the bucket you wish to migrate:<br \/>\n<\/span><\/span><\/p>\n<pre class=\"nums:false wrap:true lang:default decode:true \">cbbackupmgr config --archive \/backups\/ --repo &lt;SELF-MANAGED-BUCKET-NAME&gt; --disable-eventing --disable-analytics --disable-cluster-analytics --disable-bucket-query --disable-cluster-query --include-data &lt;SELF-MANAGED-BUCKET-NAME&gt;<\/pre>\n<\/li>\n<\/ul>\n<\/li>\n<\/ul>\n<p>NOTE:<\/p>\n<ul>\n<li style=\"list-style-type: none;\">\n<ul>\n<li style=\"font-weight: 400;\"><span style=\"font-weight: 400;\">This Repository backs up only the specified bucket<\/span><\/li>\n<li style=\"font-weight: 400;\"><span style=\"font-weight: 400;\">Analytics and Eventing are explicitly disabled<\/span><\/li>\n<\/ul>\n<\/li>\n<\/ul>\n<p><span style=\"font-weight: 400;\">Run the following command to examine the repo:<\/span><\/p>\n<pre class=\"nums:false lang:default decode:true \">cbbackupmgr info -a \/backups -all<\/pre>\n<p><span style=\"font-weight: 400;\">Basic information about your repository will be displayed.<\/span><\/p>\n<h3>Backup the self-managed Couchbase Server bucket<\/h3>\n<p><span style=\"font-weight: 400;\">Run the following command to create the backup:<\/span><\/p>\n<pre class=\"nums:false wrap:true decode-attributes:false lang:default decode:true\">cbbackupmgr backup --archive \/backups --repo &lt;SELF-MANAGED-BUCKET-NAME&gt; --cluster couchbases:\/\/&lt;SELF-MANAGED-SERVER-URL&gt; --username &lt;SELF-MANAGED-SERVER-ADMIN&gt; --password &lt;SELF-MANAGED-SERVER-ADMIN-PWD&gt; --cacert &lt;FULL-PATH-TO-SELF-MANAGED-ROOT-CERT&gt; --full-backup<\/pre>\n<p><span style=\"font-weight: 400;\">Note: Make the following substitutions in the command:<\/span><\/p>\n<ul>\n<li style=\"list-style-type: none;\">\n<ul>\n<li><span style=\"font-weight: 400;\">Replace <\/span><em><span style=\"font-weight: 400;\"><code>&lt;SELF-MANAGED-BUCKET-NAME&gt;<\/code><\/span><\/em><span style=\"font-weight: 400;\">\u00a0with the actual name of the bucket you wish to migrate<\/span><\/li>\n<li><span style=\"font-weight: 400;\">Replace <\/span><em><span style=\"font-weight: 400;\"><code>&lt;SELF-MANAGED-SERVER-ADMIN&gt;<\/code> <\/span><\/em><span style=\"font-weight: 400;\">with the administrator user name on the self-managed Couchbase Server<\/span><\/li>\n<li><span style=\"font-weight: 400;\">Replace <\/span><span style=\"font-weight: 400;\"><em><code>&lt;SELF-MANAGED-SERVER-ADMIN-PWD<\/code><\/em>&gt;<\/span><span style=\"font-weight: 400;\">\u00a0with the administrator password on the self-managed Couchbase Server<\/span><\/li>\n<li><span style=\"font-weight: 400;\">Replace <\/span><em><span style=\"font-weight: 400;\"><code>&lt;FULL-PATH-TO-SELF-MANAGED-ROOT-CERT&gt;<\/code><\/span><\/em><span style=\"font-weight: 400;\">\u00a0with the full file path to the self-managed Couchbase Server root certificate (as saved in earlier step)<\/span><\/li>\n<\/ul>\n<\/li>\n<\/ul>\n<p><span style=\"font-weight: 400;\">An example command would look like:<\/span><\/p>\n<pre class=\"nums:false wrap:true decode-attributes:false lang:default decode:true\">cbbackupmgr backup --archive \/backups --repo samplebucket --cluster couchbases:\/\/127.0.0.1 --username Administrator --password A5121U!i --cacert \/ROOT_CERT\/root-certificate.pem --full-backup<\/pre>\n<p><span style=\"font-weight: 400;\">Output from the command will be like:<\/span><\/p>\n<p><img loading=\"lazy\" decoding=\"async\" class=\"alignnone size-large wp-image-13415\" src=\"https:\/\/www.couchbase.com\/blog\/wp-content\/uploads\/2022\/06\/image1-3-1024x314.png\" alt=\"cbbackupmgr output displayed\" width=\"900\" height=\"276\" srcset=\"https:\/\/www.couchbase.com\/blog\/wp-content\/uploads\/sites\/1\/2022\/06\/image1-3-1024x314.png 1024w, https:\/\/www.couchbase.com\/blog\/wp-content\/uploads\/sites\/1\/2022\/06\/image1-3-300x92.png 300w, https:\/\/www.couchbase.com\/blog\/wp-content\/uploads\/sites\/1\/2022\/06\/image1-3-768x236.png 768w, https:\/\/www.couchbase.com\/blog\/wp-content\/uploads\/sites\/1\/2022\/06\/image1-3-20x6.png 20w, https:\/\/www.couchbase.com\/blog\/wp-content\/uploads\/sites\/1\/2022\/06\/image1-3-1320x405.png 1320w, https:\/\/www.couchbase.com\/blog\/wp-content\/uploads\/sites\/1\/2022\/06\/image1-3.png 1476w\" sizes=\"auto, (max-width: 900px) 100vw, 900px\" \/><\/p>\n<p><span style=\"font-weight: 400;\">Examine the backup using the command:<\/span><\/p>\n<pre class=\"nums:false wrap:true lang:default decode:true \">cbbackupmgr info -a \/backups -all<\/pre>\n<p><span style=\"font-weight: 400;\">Basic information about your backup will be displayed.<\/span><\/p>\n<h3>Restore the backed up self-managed bucket to Capella<\/h3>\n<p><span style=\"font-weight: 400;\">In the command line terminal, use the following command to restore the backed up self-managed bucket to Capella:<\/span><\/p>\n<pre class=\"nums:false wrap:true decode-attributes:false lang:default decode:true\">cbbackupmgr restore --archive \/backups --repo &lt;SELF-MANAGED-BUCKET-NAME&gt; --cluster couchbases:\/\/&lt;CAPELLA-ENDPOINT&gt; --username &lt;CAPELLA-DATABASE-CREDENTIALS-USER&gt; --password &lt;CAPELLA-DATABASE-CREDENTIALS-PASSWORD&gt; --cacert &lt;FULL-PATH-TO-CAPELLA-ROOT-CERT&gt;<\/pre>\n<p><span style=\"font-weight: 400;\">Note: make the following substitutions in the command:<\/span><\/p>\n<ul>\n<li style=\"list-style-type: none;\">\n<ul>\n<li><span style=\"font-weight: 400;\">Replace <\/span><em><span style=\"font-weight: 400;\"><code>&lt;SELF-MANAGED-BUCKET-NAME&gt;<\/code><\/span><\/em><span style=\"font-weight: 400;\">\u00a0with the actual name of the bucket you with to migrate<\/span><\/li>\n<li><span style=\"font-weight: 400;\">Replace <\/span><em><span style=\"font-weight: 400;\"><code>&lt;CAPELLA-ENDPOINT&gt;<\/code><\/span><\/em><span style=\"font-weight: 400;\"> with the Capella cluster endpoint url recorded earlier<\/span>\n<ul>\n<li style=\"font-weight: 400;\"><span style=\"font-weight: 400;\">If your self-managed Couchbase Server is running version 7.0.x, you will need to use the hostname URL for a DATA SERVICE NODE instead of the Wide Area Network endpoint<\/span><\/li>\n<li style=\"font-weight: 400;\"><span style=\"font-weight: 400;\">In the Couchbase Capella UI, choose the \u201cNodes\u201d tab for the destination cluster, all nodes in your cluster will be listed. Choose one of the nodes that is running the DATA SERVICE, and record the HOSTNAME for the node<\/span><\/li>\n<\/ul>\n<\/li>\n<li><span style=\"font-weight: 400;\">Replace <\/span><em><span style=\"font-weight: 400;\"><code>&lt;CAPELLA-DATABASE-CREDENTIALS-USER&gt;<\/code><\/span><\/em><span style=\"font-weight: 400;\"><em>\u00a0<\/em>with the database credentials user on the Capella cluster<\/span><\/li>\n<li><span style=\"font-weight: 400;\">Replace <\/span><span style=\"font-weight: 400;\"><em><code>&lt;CAPELLA-DATABASE-CREDENTIALS-PASSWORD&gt;<\/code><\/em> <\/span><span style=\"font-weight: 400;\">with the database credentials user password<\/span><\/li>\n<li><span style=\"font-weight: 400;\">Replace <\/span><em><span style=\"font-weight: 400;\"><code>&lt;FULL-PATH-TO-CAPELLA-ROOT-CERT&gt;<\/code><\/span><\/em><span style=\"font-weight: 400;\">\u00a0with the full file path to the Capella cluster root certificate (as saved in earlier step).<\/span><\/li>\n<\/ul>\n<\/li>\n<\/ul>\n<p><span style=\"font-weight: 400;\">The command may take a few mins to run depending on the size of your cluster. Once completed you should see details about the restored backup displayed in the terminal, and a message reading: \u201c<\/span><em><span style=\"font-weight: 400;\">Restore completed successfully<\/span><\/em><span style=\"font-weight: 400;\">\u201d<\/span><\/p>\n<h3>Examine the migrated documents and indexes<\/h3>\n<ul>\n<li style=\"list-style-type: none;\">\n<ul>\n<li><span style=\"font-weight: 400;\">In the Couchbase Capella UI, choose <strong>Tools &gt; Documents<\/strong> for your target cluster<\/span><\/li>\n<li><span style=\"font-weight: 400;\">You should see that all of your self-managed cluster documents have been migrated to Capella<\/span><\/li>\n<li><span style=\"font-weight: 400;\">In the Couchbase Capella UI, choose <strong>Tools &gt; Indexes<\/strong> for your target cluster<\/span><\/li>\n<li><span style=\"font-weight: 400;\">You should see that all of your self-managed cluster indexes have been migrated to Capella<\/span><\/li>\n<\/ul>\n<\/li>\n<\/ul>\n<p><span style=\"font-weight: 400;\"><strong>NOTE<\/strong>: Any indexes with definitions set as <\/span><em><span style=\"font-weight: 400;\"><code>defer_build:true<\/code> <\/span><\/em><span style=\"font-weight: 400;\">will be migrated, but will be listed as <em><code>CREATED<\/code><\/em>. These indexes still need to be built on Capella.<\/span><\/p>\n<h3>Build indexes on Capella<\/h3>\n<ul>\n<li style=\"list-style-type: none;\">\n<ul>\n<li><span style=\"font-weight: 400;\">In the Couchbase Capella UI, choose <strong>Tools &gt; Query Workbench<\/strong> for your target cluster<\/span><\/li>\n<li><span style=\"font-weight: 400;\">The following query will create BUILD statements for any indexes that were created but not built during migration. Copy\/paste the following query to the Query Workbench in Capella, then click <strong>Execute<\/strong>:<\/span><\/li>\n<\/ul>\n<\/li>\n<\/ul>\n<pre class=\"decode-attributes:false lang:default decode:true\">SELECT RAW CONCAT(\"BUILD INDEX ON \", k ,\u00a0 \"(['\", CONCAT2 (\"','\", inames), \"']);\")\r\nFROM system:indexes AS s\r\nLET bid = CONCAT(\"`\",s.bucket_id, \"`\"),\r\n\u00a0\u00a0\u00a0\u00a0sid = CONCAT(\"`\", s.scope_id, \"`\"),\r\n\u00a0\u00a0\u00a0\u00a0kid = CONCAT(\"`\", s.keyspace_id, \"`\"),\r\n\u00a0\u00a0\u00a0\u00a0k = NVL2(bid, CONCAT2(\".\", bid, sid, kid), kid)\r\nWHERE s.namespace_id = \"default\"\r\nGROUP BY k\r\nLETTING inames = ARRAY_AGG(s.name) FILTER (WHERE s.state = 'deferred')\r\nHAVING ARRAY_LENGTH(inames) &gt; 0;<\/pre>\n<p><span style=\"font-weight: 400;\">The query results will return a BUILD statement to build the created indexes. Note there will be a BUILD statement for each scope in your cluster. The results will look something like so:<\/span><\/p>\n<pre class=\"decode-attributes:false lang:default decode:true\">[\r\n\u00a0\u00a0\"BUILD INDEX ON `couchmusic2`.`music`.`subregions`(['region']);\",\r\n\u00a0\u00a0\"BUILD INDEX ON `couchmusic2`.`music`.`countries`(['country_code','country_region_number']);\"\r\n]<\/pre>\n<p><span style=\"font-weight: 400;\">Copy each BUILD statement (between the double quotes), then paste to the Query Editor and click <strong>Execute<\/strong> to build the indexes. Repeat for each BUILD statement,<\/span><\/p>\n<p><span style=\"font-weight: 400;\">Congratulations, you have just migrated data and indexes from your self-managed Couchbase Server cluster to Capella!<\/span><\/p>\n<hr \/>\n<h2>Migrate using cbbackup and cbrestore &#8211; option 2<\/h2>\n<p><b>This option applies to the following versions of self-managed Couchbase Server:<\/b><\/p>\n<ul>\n<li style=\"list-style-type: none;\">\n<ul>\n<li style=\"font-weight: 400;\"><span style=\"font-weight: 400;\">Community Edition version 6.6<\/span><\/li>\n<\/ul>\n<\/li>\n<\/ul>\n<p><b><i>Use the cbbackup CLI tool:<\/i><\/b><\/p>\n<ul>\n<li style=\"list-style-type: none;\">\n<ul>\n<li><span style=\"font-weight: 400;\"><em>cbbackup<\/em> is located in the root directory of your self-managed Couchbase Server installation<\/span><\/li>\n<li><span style=\"font-weight: 400;\">You use a command line terminal to work with cbbackup<\/span><\/li>\n<li><span style=\"font-weight: 400;\">Depending on the platform, cbbackup is installed with Couchbase Server in the following location:<\/span>\n<ul>\n<li><span style=\"font-weight: 400;\"><strong>Linux<\/strong>:\u00a0<\/span><i><span style=\"font-weight: 400;\">\/opt\/couchbase\/bin\/cbbackup<\/span><\/i><\/li>\n<li><span style=\"font-weight: 400;\"><strong>Windows<\/strong> (assuming default installation): <\/span><i>C:\\Program Files\\Couchbase\\Server\\bin\\cbbackup<\/i><\/li>\n<li><strong>Mac OS X<\/strong>: <em>\/Applications\/Couchbase Server.app\/Contents\/Resources\/couchbase-core\/bin\/cbbackup<\/em><\/li>\n<\/ul>\n<\/li>\n<\/ul>\n<\/li>\n<\/ul>\n<p><span style=\"font-weight: 400;\">If you do not have direct access to the install directory for Couchbase Server, you can get the <em>cbbackup<\/em> and <em>cbrestore<\/em> command line utilities by <\/span><a href=\"https:\/\/www.couchbase.com\/downloads\/\" target=\"_blank\" rel=\"noopener\"><span style=\"font-weight: 400;\">downloading Couchbase Server<\/span><\/a><span style=\"font-weight: 400;\"> and installing it on your local system.<\/span><\/p>\n<h3>Create a backup on the self-managed Couchbase Server system<\/h3>\n<p><span style=\"font-weight: 400;\">In the command line terminal, create a directory for local backups from the self-managed Couchbase Server. The following command will create the directory in your system root folder:<\/span><\/p>\n<p style=\"padding-left: 40px;\"><em><span style=\"font-weight: 400;\">mkdir \/backups\/<\/span><\/em><\/p>\n<p><span style=\"font-weight: 400;\">Run the following <em>cbbackup<\/em> command to create the backup:<\/span><\/p>\n<pre class=\"nums:false wrap:true decode-attributes:false lang:default decode:true\">cbbackup -u &lt;SELF-MANAGED-SERVER-ADMIN&gt; -p &lt;SELF-MANAGED-SERVER-ADMIN-PWD&gt; couchbase:\/\/&lt;URL-TO-SELF-MANAGED-COUCHBASE-SERVER&gt; \/backups -b &lt;SELF-MANAGED-BUCKET-NAME&gt;<\/pre>\n<p>M<span style=\"font-weight: 400;\">ake the following substitutions in the command:<\/span><\/p>\n<ul>\n<li style=\"list-style-type: none;\">\n<ul>\n<li><span style=\"font-weight: 400;\">Replace <\/span><em><span style=\"font-weight: 400;\"><code>&lt;SELF-MANAGED-SERVER-ADMIN&gt;<\/code><\/span><\/em><span style=\"font-weight: 400;\">\u00a0with the administrator user name on the self-managed Couchbase Server<\/span><\/li>\n<li><span style=\"font-weight: 400;\">Replace <\/span><em><span style=\"font-weight: 400;\"><code>&lt;SELF-MANAGED-SERVER-ADMIN-PWD&gt;<\/code> <\/span><\/em><span style=\"font-weight: 400;\">with the administrator password on the self-managed Couchbase Server<\/span><\/li>\n<li><span style=\"font-weight: 400;\">Replace <\/span><em><span style=\"font-weight: 400;\"><code>&lt;URL-TO-SELF-MANAGED-COUCHBASE-SERVER&gt; <\/code><\/span><\/em><span style=\"font-weight: 400;\">with the url to your self-managed Couchbase Server<\/span><\/li>\n<li><span style=\"font-weight: 400;\">Replace <\/span><em><span style=\"font-weight: 400;\"><code>&lt;SELF-MANAGED-BUCKET-NAME&gt;<\/code><\/span><\/em><span style=\"font-weight: 400;\"> with the name of the bucket you wish to migrate<\/span>\n<ul>\n<li>NOTE: This command backs up only the specified bucket<\/li>\n<\/ul>\n<\/li>\n<\/ul>\n<\/li>\n<\/ul>\n<p><span style=\"font-weight: 400;\">Run the following command to examine the backup:<\/span><\/p>\n<ul>\n<li style=\"list-style-type: none;\">\n<ul>\n<li><em><span style=\"font-weight: 400;\">ls \/backups<\/span><\/em><\/li>\n<\/ul>\n<\/li>\n<\/ul>\n<p><span style=\"font-weight: 400;\">For Windows use: <\/span><\/p>\n<ul>\n<li style=\"list-style-type: none;\">\n<ul>\n<li><em><span style=\"font-weight: 400;\">dir \/backups<\/span><\/em><\/li>\n<\/ul>\n<\/li>\n<\/ul>\n<p><span style=\"font-weight: 400;\">Basic information about your backup will be displayed<\/span><\/p>\n<p><b><i>Use the cbrestore CLI tool:<\/i><\/b><\/p>\n<ul>\n<li><span style=\"font-weight: 400;\"><em>cbrestore<\/em> is located in the root directory of your self-managed Couchbase Server installation.<\/span><\/li>\n<li><span style=\"font-weight: 400;\">You use a command line terminal to work with <em>cbrestore<\/em>.<\/span><\/li>\n<li><span style=\"font-weight: 400;\">Depending on the platform, <em>cbrestore<\/em> is installed with Couchbase Server in the following location:<\/span>\n<ul>\n<li><span style=\"font-weight: 400;\"><strong>Linux<\/strong>:\u00a0<\/span><i><span style=\"font-weight: 400;\">\/opt\/couchbase\/bin\/cbrestore<\/span><\/i><\/li>\n<li><span style=\"font-weight: 400;\"><strong>Windows<\/strong> (assuming default installation):\u00a0<\/span><i><span style=\"font-weight: 400;\">C:\\Program Files\\Couchbase\\Server\\bin\\cbrestore<\/span><\/i><\/li>\n<li><span style=\"font-weight: 400;\"><strong>Mac OS X<\/strong>:\u00a0<\/span><i><span style=\"font-weight: 400;\">\/Applications\/Couchbase Server.app\/Contents\/Resources\/couchbase-core\/bin\/cbrestore<\/span><\/i><\/li>\n<\/ul>\n<\/li>\n<\/ul>\n<h3>Restore the backup to Capella using cbrestore<\/h3>\n<p><span style=\"font-weight: 400;\">Run the following <em>cbrestore<\/em> command to restore the backup on Capella:<\/span><\/p>\n<pre class=\"nums:false wrap:true decode-attributes:false lang:default decode:true\">cbrestore \/backups https:\/\/&lt;CAPELLA-NODE-HOSTNAME&gt;:18091 --bucket-source=&lt;SELF-MANAGED-BUCKET-NAME&gt; --bucket-destination=&lt;CAPELLA-BUCKET-NAME&gt; --from-date=&lt;DATE-OF-BACKUP&gt; --to-date=&lt;DATE-FOLLOWING-BACKUP&gt; --username=&lt;CAPELLA-DATABASE-CREDENTIALS-USER&gt; --password=&lt;CAPELLA-DATABASE-CREDENTIALS-PASSWORD&gt; --ssl --cacert=&lt;FULL-PATH-TO-CAPELLA-ROOT-CERT&gt;<\/pre>\n<p><span style=\"font-weight: 400;\">Make the following substitutions in the command:<\/span><\/p>\n<ul>\n<li style=\"list-style-type: none;\">\n<ul>\n<li><span style=\"font-weight: 400;\">Replace <\/span><em><span style=\"font-weight: 400;\"><code>&lt;CAPELLA-NODE-HOSTNAME&gt;<\/code><\/span><\/em><span style=\"font-weight: 400;\">\u00a0with the node hostname from your Capella cluster (recorded earlier)<\/span><\/li>\n<li><span style=\"font-weight: 400;\">Replace <\/span><em><span style=\"font-weight: 400;\"><code>&lt;SELF-MANAGED-BUCKET-NAME&gt;<\/code><\/span><\/em><span style=\"font-weight: 400;\">\u00a0with the name of the bucket you with to migrate<\/span><\/li>\n<li><span style=\"font-weight: 400;\">Replace <\/span><em><span style=\"font-weight: 400;\"><code>&lt;CAPELLA-BUCKET-NAME&gt;<\/code><\/span><\/em><span style=\"font-weight: 400;\"> with the name of the target bucket on Capella<\/span><\/li>\n<li><span style=\"font-weight: 400;\">Replace <\/span><em><span style=\"font-weight: 400;\"><code>&lt;DATE-OF-BACKUP&gt;<\/code><\/span><\/em><span style=\"font-weight: 400;\"> with the date that you took the backup<\/span>\n<ul>\n<li style=\"font-weight: 400;\"><span style=\"font-weight: 400;\">NOTE: use the date format <em>YYYY-MM-DD<\/em><\/span><\/li>\n<\/ul>\n<\/li>\n<li><span style=\"font-weight: 400;\">Replace <\/span><em><span style=\"font-weight: 400;\"><code>&lt;DATE-FOLLOWING-BACKUP&gt;<\/code><\/span><\/em><span style=\"font-weight: 400;\"> with the date following the date that you took the backup<\/span>\n<ul>\n<li style=\"font-weight: 400;\"><span style=\"font-weight: 400;\">NOTE: use the date format <em>YYYY-MM-DD<\/em><\/span><\/li>\n<\/ul>\n<\/li>\n<li><span style=\"font-weight: 400;\">Replace <\/span><em><span style=\"font-weight: 400;\"><code>&lt;CAPELLA-DATABASE-CREDENTIALS-USER&gt;<\/code><\/span><\/em><span style=\"font-weight: 400;\"><em>\u00a0<\/em>with the database credentials user on the Capella cluster<\/span><\/li>\n<li><span style=\"font-weight: 400;\">Replace <\/span><em><span style=\"font-weight: 400;\"><code>&lt;CAPELLA-DATABASE-CREDENTIALS-PASSWORD&gt;<\/code> <\/span><\/em><span style=\"font-weight: 400;\">with the database credentials user password<\/span><\/li>\n<li><span style=\"font-weight: 400;\">Replace <\/span><em><span style=\"font-weight: 400;\"><code>&lt;FULL-PATH-TO-CAPELLA-ROOT-CERT&gt;<\/code><\/span><\/em><span style=\"font-weight: 400;\">\u00a0with the full file path to the Capella cluster root certificate (as saved in earlier step).<\/span><\/li>\n<\/ul>\n<\/li>\n<\/ul>\n<p><span style=\"font-weight: 400;\">Here is an example of what the command should look like:<\/span><\/p>\n<pre class=\"nums:false wrap:true decode-attributes:false lang:default decode:true\">cbrestore \/backups https:\/\/12345xxxxxx.cloud.couchbase.com:18091 --bucket-source=migration-sample --bucket-destination=migration-sample --from-date=2022-05-19 --to-date=2022-05-20 --username=dataUser --password=A5121U!i --ssl --cacert=\/ROOT_CERT\/Capella-root-certificate.pem<\/pre>\n<p><span style=\"font-weight: 400;\">The command may take a few mins to run depending on the size of your cluster. Once completed you should see details about the restored backup displayed in the terminal, and a message reading: <\/span><em><span style=\"font-weight: 400;\">Done.<\/span><\/em><\/p>\n<p><b><i>Examine the migrated documents and indexes:<\/i><\/b><\/p>\n<ul>\n<li style=\"list-style-type: none;\">\n<ul>\n<li><span style=\"font-weight: 400;\">In the Couchbase Capella UI, choose <strong>Tools &gt; Documents<\/strong> for your target cluster<\/span><\/li>\n<li><span style=\"font-weight: 400;\">You should see that all of your self-managed cluster documents have been migrated to Capella<\/span><\/li>\n<li><span style=\"font-weight: 400;\">In the Couchbase Capella UI, choose <strong>Tools &gt; Indexes<\/strong> for your target cluster<\/span><\/li>\n<li><span style=\"font-weight: 400;\">You should see that all of your self-managed cluster indexes have been migrated to Capella<\/span><\/li>\n<li><span style=\"font-weight: 400;\">NOTE: Any indexes with definitions set as <\/span><span style=\"font-weight: 400;\"><em><code>defer_build:true<\/code><\/em> <\/span><span style=\"font-weight: 400;\">will be migrated, but will be listed as <em>CREATED<\/em> but not <em>READY<\/em>. These indexes still need to be built on Capella<\/span><\/li>\n<\/ul>\n<\/li>\n<\/ul>\n<h3>Build indexes on Capella<\/h3>\n<ul>\n<li style=\"list-style-type: none;\">\n<ul>\n<li><span style=\"font-weight: 400;\">In the Couchbase Capella UI, choose <strong>Tools &gt; Query Workbench<\/strong> in your target cluster<\/span><\/li>\n<li><span style=\"font-weight: 400;\">The following query will create BUILD statements for any indexes that were created but not built during migration.<\/span><\/li>\n<li><span style=\"font-weight: 400;\">Copy\/paste the following query to the Query Workbench in Capella, then click <strong>Execute<\/strong>:<\/span><\/li>\n<\/ul>\n<\/li>\n<\/ul>\n<pre class=\"decode-attributes:false lang:default decode:true\">SELECT RAW CONCAT(\"BUILD INDEX ON \", k ,\u00a0 \"(['\", CONCAT2 (\"','\", inames), \"']);\")\r\nFROM system:indexes AS s\r\nLET bid = CONCAT(\"`\",s.bucket_id, \"`\"),\r\n\u00a0\u00a0\u00a0\u00a0sid = CONCAT(\"`\", s.scope_id, \"`\"),\r\n\u00a0\u00a0\u00a0\u00a0kid = CONCAT(\"`\", s.keyspace_id, \"`\"),\r\n\u00a0\u00a0\u00a0\u00a0k = NVL2(bid, CONCAT2(\".\", bid, sid, kid), kid)\r\nWHERE s.namespace_id = \"default\"\r\nGROUP BY k\r\nLETTING inames = ARRAY_AGG(s.name) FILTER (WHERE s.state = 'deferred')\r\nHAVING ARRAY_LENGTH(inames) &gt; 0;<\/pre>\n<p>The query results will return a <em>BUILD<\/em> statement to build the created indexes. The results will look something like so:<\/p>\n<pre class=\"wrap:true decode-attributes:false lang:default decode:true\">[\r\n\r\n  \"BUILD INDEX ON `sample-bucket`(['def_airportname','def_city','def_faa','def_icao','def_name_type','def_primary','def_route_src_dst_day','def_schedule_utc','def_sourceairport','def_type']);\"\r\n\r\n]<\/pre>\n<p><span style=\"font-weight: 400;\">Copy the <em>BUILD<\/em> statement (between the double quotes), then paste to the Query Editor and click <strong>Execute<\/strong>\u00a0to build the indexes.<\/span><\/p>\n<p><span style=\"font-weight: 400;\">Congratulations, you have just migrated data and indexes from your self-managed Couchbase Server cluster to Capella!<\/span><\/p>\n<hr \/>\n<h2>Ongoing migration via Cross Data Center Replication (XDCR)<\/h2>\n<p><b>This option applies to the following versions of self-managed Couchbase Server:<\/b><\/p>\n<ul>\n<li style=\"list-style-type: none;\">\n<ul>\n<li style=\"font-weight: 400;\"><span style=\"font-weight: 400;\">Enterprise Edition version 6.6, 7.0.x, 7.1<\/span><\/li>\n<\/ul>\n<\/li>\n<\/ul>\n<p><span style=\"font-weight: 400;\">This is an optional step. Consider using XDCR if you wish to continue migrating data for a period of time beyond the initial migration using the CLI tools.<\/span><\/p>\n<p>&nbsp;<\/p>\n<h3>Connect self-managed Couchbase Server cluster to Couchbase Capella cluster<\/h3>\n<p><strong>Enterprise Edition only<\/strong><\/p>\n<ul>\n<li style=\"list-style-type: none;\">\n<ul>\n<li><span style=\"font-weight: 400;\">In the Couchbase Capella UI main navigation click <strong>Clusters<\/strong>, then click on the target cluster for migration<\/span><\/li>\n<li><span style=\"font-weight: 400;\">Click the <strong>Connect<\/strong> tab, then under <em>Wide Area Network<\/em> click <strong>Manage Allowed IP<\/strong><\/span><\/li>\n<li><span style=\"font-weight: 400;\">On the Allowed IP screen, click <strong>Add Allowed IP<\/strong><\/span><\/li>\n<li><span style=\"font-weight: 400;\">On the flyout editor enter the IP address of your self-managed Couchbase Server cluster nodes (or click <strong>+ Add My IP<\/strong> to automatically paste in your current IP address)<\/span><\/li>\n<li><span style=\"font-weight: 400;\">Click <strong>Add IP<\/strong><\/span><\/li>\n<li><span style=\"font-weight: 400;\">Repeat for each cluster node IP address<\/span><\/li>\n<li><span style=\"font-weight: 400;\">Click <strong>&lt; BACK<\/strong>\u00a0to go to the previous screen<\/span><\/li>\n<\/ul>\n<\/li>\n<\/ul>\n<p><b>Note:<\/b><span style=\"font-weight: 400;\"> If whitelisting the IP fails, in most cases it is related to firewall issues. <a href=\"https:\/\/docs.couchbase.com\/server\/current\/install\/install-ports.html\">See Couchbase documentation<\/a> for information on the default ports used by Couchbase Server:<\/span><\/p>\n<ul>\n<li style=\"list-style-type: none;\">\n<ul>\n<li><span style=\"font-weight: 400;\">Under <em>Wide Area Network<\/em>, copy and save the displayed URL, this is the endpoint connection for your Capella cluster. You will use this URL later to connect your self-managed Couchbase Server cluster to Couchbase Capella<\/span><\/li>\n<li><span style=\"font-weight: 400;\">Under <em>Root Certificate<\/em>, click <strong>Copy<\/strong>\u00a0(this will capture the certificate to your clipboard for pasting)<\/span><\/li>\n<li><span style=\"font-weight: 400;\">Log in to your self-managed Couchbase Server Web Console, and in the main navigation click <strong>XDCR<\/strong>. Click <strong>Add Remote<\/strong><\/span><\/li>\n<\/ul>\n<\/li>\n<\/ul>\n<p><span style=\"font-weight: 400;\">Enter the following settings:<\/span><\/p>\n<ul>\n<li style=\"list-style-type: none;\">\n<ul>\n<li style=\"font-weight: 400;\"><span style=\"font-weight: 400;\"><strong>Cluster Name<\/strong> \u2013 enter a name for the remote cluster connection<\/span><\/li>\n<li style=\"font-weight: 400;\"><span style=\"font-weight: 400;\"><strong>IP\/Hostname<\/strong> \u2013 enter the Couchbase Capella cluster endpoint URL you copied earlier<\/span><\/li>\n<li style=\"font-weight: 400;\"><span style=\"font-weight: 400;\"><strong>Username<\/strong> <strong>for Remote Cluster<\/strong> \u2013 enter the database credentials username for your Capella target cluster<\/span><\/li>\n<li style=\"font-weight: 400;\"><span style=\"font-weight: 400;\"><strong>Password<\/strong> \u2013 enter the password for the database credentials user for your Capella target cluster<\/span><\/li>\n<li style=\"font-weight: 400;\"><span style=\"font-weight: 400;\"><strong>Enable Secure Connection<\/strong> \u2013 checked<\/span><\/li>\n<li style=\"font-weight: 400;\"><span style=\"font-weight: 400;\">Select the <strong>Full<\/strong>\u00a0radio button<\/span><\/li>\n<li style=\"font-weight: 400;\"><span style=\"font-weight: 400;\">Paste the Capella cluster root certificate you copied earlier<\/span><\/li>\n<li style=\"font-weight: 400;\"><span style=\"font-weight: 400;\">Click <strong>Save<\/strong><\/span><\/li>\n<\/ul>\n<\/li>\n<\/ul>\n<h3>Set up Couchbase XDCR<\/h3>\n<p><strong>Enterprise Edition only:<\/strong><\/p>\n<p><span style=\"font-weight: 400;\">Couchbase cross data center replication (XDCR) allows data to be replicated across clusters that are located in different data centers. It can be used to migrate data into Couchbase Capella from self-managed Couchbase Server clusters. <\/span><\/p>\n<p><span style=\"font-weight: 400;\">NOTE: XDCR does not migrate indexes.<\/span><\/p>\n<p><span style=\"font-weight: 400;\">In your self-managed Couchbase Server Web Console click <strong>XDCR<\/strong> in the main navigation, then click <strong>Add Replication<\/strong>\u00a0<\/span><\/p>\n<p><span style=\"font-weight: 400;\">Enter the following settings:<\/span><\/p>\n<ul>\n<li style=\"list-style-type: none;\">\n<ul>\n<li style=\"font-weight: 400;\"><span style=\"font-weight: 400;\"><strong>Replicate From Bucket<\/strong> \u2013 select the source bucket for migration<\/span><\/li>\n<li style=\"font-weight: 400;\"><span style=\"font-weight: 400;\"><strong>Remote Bucket<\/strong> \u2013 enter the remote bucket name<\/span><\/li>\n<li style=\"font-weight: 400;\"><span style=\"font-weight: 400;\"><strong>Remote Cluster<\/strong> \u2013 select the remote cluster you created earlier<\/span><\/li>\n<li style=\"font-weight: 400;\"><span style=\"font-weight: 400;\">Click <strong>Save replication<\/strong><\/span><\/li>\n<\/ul>\n<\/li>\n<\/ul>\n<p><span style=\"font-weight: 400;\">The replication process should begin within a few seconds.<\/span><\/p>\n<h3>Verify the migration<\/h3>\n<p><b><i>Data migration:<\/i><\/b><\/p>\n<ul>\n<li style=\"list-style-type: none;\">\n<ul>\n<li><span style=\"font-weight: 400;\">In the Couchbase Capella UI, choose <strong>Clusters<\/strong> in the main navigation and then click the target cluster in your cluster list<\/span><\/li>\n<li><span style=\"font-weight: 400;\">Choose the <strong>Buckets<\/strong> tab for your target cluster. Verify that the number of <em>Items<\/em>\u00a0(documents) in the target bucket match the number of items in the source bucket<\/span><\/li>\n<li><span style=\"font-weight: 400;\">In the target cluster, choose <strong>Documents<\/strong> in the <strong>Tools<\/strong>\u00a0dropdown list. Verify that all documents were migrated<\/span><\/li>\n<\/ul>\n<\/li>\n<\/ul>\n<p><b><i>Index migration:<\/i><\/b><\/p>\n<p><span style=\"font-weight: 400;\">In the Couchbase Capella UI, choose <strong>Indexes<\/strong> in the <strong>Tools<\/strong> dropdown list for your target cluster. Verify that the indexes are migrated and built.<\/span><\/p>\n<p><b><i>Query runtime:<\/i><\/b><\/p>\n<p><span style=\"font-weight: 400;\">In the Couchbase Capella UI, choose <strong>Query Workbench<\/strong> in the <strong>Tools<\/strong>\u00a0dropdown list for your target cluster.\u00a0<\/span><\/p>\n<p><span style=\"font-weight: 400;\">Run a sample SQL++ query or a query used in your application to test that you receive the same results as the query in your self-managed Couchbase Server cluster.<\/span><\/p>\n<h2>Related resources<\/h2>\n<p><b>Preparing to migrate:<\/b><\/p>\n<ul>\n<li style=\"list-style-type: none;\">\n<ul>\n<li style=\"font-weight: 400;\"><a href=\"https:\/\/cloud.couchbase.com\/sign-up?ref=blog\" target=\"_blank\" rel=\"noopener\"><span style=\"font-weight: 400;\">Get started with the Couchbase Capella free tier<\/span><\/a><\/li>\n<li style=\"font-weight: 400;\"><a href=\"https:\/\/docs.couchbase.com\/cloud\/index.html\" target=\"_blank\" rel=\"noopener\"><span style=\"font-weight: 400;\">Couchbase Capella documentation<\/span><\/a><\/li>\n<li style=\"font-weight: 400;\"><a href=\"https:\/\/cloud.couchbase.com\/sign-up\" target=\"_blank\" rel=\"noopener\"><span style=\"font-weight: 400;\">Create a Couchbase Capella account<\/span><\/a><\/li>\n<li style=\"font-weight: 400;\"><a href=\"https:\/\/docs.couchbase.com\/cloud\/clusters\/sizing.html\" target=\"_blank\" rel=\"noopener\"><span style=\"font-weight: 400;\">Couchbase Capella sizing guidelines<\/span><\/a><\/li>\n<li style=\"font-weight: 400;\"><a href=\"https:\/\/docs.couchbase.com\/cloud\/clusters\/scale-cluster.html\" target=\"_blank\" rel=\"noopener\"><span style=\"font-weight: 400;\">Couchbase Capella cluster scaling<\/span><\/a><span style=\"font-weight: 400;\">\u00a0<\/span><\/li>\n<li style=\"font-weight: 400;\"><a href=\"https:\/\/docs.couchbase.com\/cloud\/clouds\/private-network.html\" target=\"_blank\" rel=\"noopener\"><span style=\"font-weight: 400;\">Configure a private network on Couchbase Capella<\/span><\/a><span style=\"font-weight: 400;\">\u00a0<\/span><\/li>\n<li style=\"font-weight: 400;\"><a href=\"https:\/\/docs.couchbase.com\/server\/current\/introduction\/intro.html\" target=\"_blank\" rel=\"noopener\"><span style=\"font-weight: 400;\">Couchbase Server documentation<\/span><\/a><\/li>\n<li style=\"font-weight: 400;\"><a href=\"https:\/\/docs.couchbase.com\/server\/current\/install\/sizing-general.html\" target=\"_blank\" rel=\"noopener\"><span style=\"font-weight: 400;\">Couchbase Server cluster sizing guidelines<\/span><\/a><\/li>\n<li style=\"font-weight: 400;\"><a href=\"https:\/\/www.couchbase.com\/products\/editions\/\" target=\"_blank\" rel=\"noopener\"><span style=\"font-weight: 400;\">Couchbase Enterprise vs Community Edition<\/span><\/a><\/li>\n<li><a href=\"https:\/\/www.couchbase.com\/resources\/concepts\/what-is-cloud-migration\/\" target=\"_blank\" rel=\"noopener\">What is cloud migration?<\/a><\/li>\n<\/ul>\n<\/li>\n<\/ul>\n<p><b>Deploy and configure resources on Couchbase Capella:<\/b><\/p>\n<ul>\n<li style=\"list-style-type: none;\">\n<ul>\n<li style=\"font-weight: 400;\"><a href=\"https:\/\/docs.couchbase.com\/cloud\/security\/manage-database-users.html\" target=\"_blank\" rel=\"noopener\"><span style=\"font-weight: 400;\">Configure a database credential on Couchbase Capella<\/span><\/a><\/li>\n<li style=\"font-weight: 400;\"><a href=\"https:\/\/docs.couchbase.com\/cloud\/clusters\/data-service\/manage-buckets.html\" target=\"_blank\" rel=\"noopener\"><span style=\"font-weight: 400;\">Couchbase Capella buckets overview<\/span><\/a><\/li>\n<li style=\"font-weight: 400;\"><a href=\"https:\/\/docs.couchbase.com\/cloud\/clusters\/clusters.html\" target=\"_blank\" rel=\"noopener\"><span style=\"font-weight: 400;\">Couchbase Capella cluster overview<\/span><\/a><\/li>\n<li style=\"font-weight: 400;\"><a href=\"https:\/\/docs.couchbase.com\/cloud\/projects\/projects.html\" target=\"_blank\" rel=\"noopener\"><span style=\"font-weight: 400;\">Couchbase Capella projects overview<\/span><\/a><\/li>\n<li style=\"font-weight: 400;\"><a href=\"https:\/\/docs.couchbase.com\/cloud\/clusters\/create-cluster.html\" target=\"_blank\" rel=\"noopener\"><span style=\"font-weight: 400;\">Create a cluster on Couchbase Capella<\/span><\/a><\/li>\n<li style=\"font-weight: 400;\"><a href=\"https:\/\/docs.couchbase.com\/cloud\/clusters\/data-service\/manage-buckets.html#add-bucket\" target=\"_blank\" rel=\"noopener\"><span style=\"font-weight: 400;\">Create a new bucket on Couchbase Capella<\/span><\/a><\/li>\n<\/ul>\n<\/li>\n<\/ul>\n<p>&nbsp;<\/p>\n","protected":false},"excerpt":{"rendered":"<p>Steps to migrate self-managed Couchbase Server clusters to Couchbase Capella\u2122 Database-as-a-Service (DBaaS) Couchbase Capella is the easiest and fastest way to begin with Couchbase. This fully managed Database-as-a-Service eliminates your database management efforts and reduces costs while delivering flexibility across [&hellip;]<\/p>\n","protected":false},"author":82066,"featured_media":16453,"comment_status":"open","ping_status":"open","sticky":false,"template":"","format":"standard","meta":{"_acf_changed":false,"inline_featured_image":false,"footnotes":""},"categories":[2225,1816,9415],"tags":[1797,9405],"ppma_author":[9657],"class_list":["post-13413","post","type-post","status-publish","format-standard","has-post-thumbnail","hentry","category-cloud","category-couchbase-server","category-xdcr","tag-cbbackupmgr","tag-database-migration"],"acf":[],"yoast_head":"<!-- This site is optimized with the Yoast SEO Premium plugin v25.8 (Yoast SEO v25.8) - https:\/\/yoast.com\/wordpress\/plugins\/seo\/ -->\n<title>Couchbase Server to Couchbase Capella Migration Steps<\/title>\n<meta name=\"description\" content=\"This Couchbase blog provides steps you need to take to migrate self-managed Couchbase Server clusters to Couchbase Capella\u2122 Database-as-a-Service (DBaaS).\" \/>\n<meta name=\"robots\" content=\"index, follow, max-snippet:-1, max-image-preview:large, max-video-preview:-1\" \/>\n<link rel=\"canonical\" href=\"https:\/\/www.couchbase.com\/blog\/how-to-migrate-from-couchbase-server-to-couchbase-capella\/\" \/>\n<meta property=\"og:locale\" content=\"en_US\" \/>\n<meta property=\"og:type\" content=\"article\" \/>\n<meta property=\"og:title\" content=\"How To Migrate From Couchbase Server to Couchbase Capella\" \/>\n<meta property=\"og:description\" content=\"This Couchbase blog provides steps you need to take to migrate self-managed Couchbase Server clusters to Couchbase Capella\u2122 Database-as-a-Service (DBaaS).\" \/>\n<meta property=\"og:url\" content=\"https:\/\/www.couchbase.com\/blog\/how-to-migrate-from-couchbase-server-to-couchbase-capella\/\" \/>\n<meta property=\"og:site_name\" content=\"The Couchbase Blog\" \/>\n<meta property=\"article:published_time\" content=\"2024-10-16T18:11:37+00:00\" \/>\n<meta property=\"article:modified_time\" content=\"2025-06-14T04:51:41+00:00\" \/>\n<meta property=\"og:image\" content=\"https:\/\/www.couchbase.com\/blog\/wp-content\/uploads\/sites\/1\/2022\/06\/blog-capella-migration-1024x536.png\" \/>\n\t<meta property=\"og:image:width\" content=\"1024\" \/>\n\t<meta property=\"og:image:height\" content=\"536\" \/>\n\t<meta property=\"og:image:type\" content=\"image\/png\" \/>\n<meta name=\"author\" content=\"Couchbase Product Marketing\" \/>\n<meta name=\"twitter:card\" content=\"summary_large_image\" \/>\n<meta name=\"twitter:label1\" content=\"Written by\" \/>\n\t<meta name=\"twitter:data1\" content=\"Couchbase Product Marketing\" \/>\n\t<meta name=\"twitter:label2\" content=\"Est. reading time\" \/>\n\t<meta name=\"twitter:data2\" content=\"16 minutes\" \/>\n<script type=\"application\/ld+json\" class=\"yoast-schema-graph\">{\"@context\":\"https:\/\/schema.org\",\"@graph\":[{\"@type\":\"Article\",\"@id\":\"https:\/\/www.couchbase.com\/blog\/how-to-migrate-from-couchbase-server-to-couchbase-capella\/#article\",\"isPartOf\":{\"@id\":\"https:\/\/www.couchbase.com\/blog\/how-to-migrate-from-couchbase-server-to-couchbase-capella\/\"},\"author\":{\"name\":\"Couchbase Product Marketing\",\"@id\":\"https:\/\/www.couchbase.com\/blog\/#\/schema\/person\/befa2a9de827aed2f8354f939cd6598e\"},\"headline\":\"How To Migrate From Couchbase Server to Couchbase Capella\",\"datePublished\":\"2024-10-16T18:11:37+00:00\",\"dateModified\":\"2025-06-14T04:51:41+00:00\",\"mainEntityOfPage\":{\"@id\":\"https:\/\/www.couchbase.com\/blog\/how-to-migrate-from-couchbase-server-to-couchbase-capella\/\"},\"wordCount\":3603,\"commentCount\":0,\"publisher\":{\"@id\":\"https:\/\/www.couchbase.com\/blog\/#organization\"},\"image\":{\"@id\":\"https:\/\/www.couchbase.com\/blog\/how-to-migrate-from-couchbase-server-to-couchbase-capella\/#primaryimage\"},\"thumbnailUrl\":\"https:\/\/www.couchbase.com\/blog\/wp-content\/uploads\/sites\/1\/2022\/06\/blog-capella-migration.png\",\"keywords\":[\"cbbackupmgr\",\"database migration\"],\"articleSection\":[\"Couchbase Capella\",\"Couchbase Server\",\"Cross Data Center Replication (XDCR)\"],\"inLanguage\":\"en-US\",\"potentialAction\":[{\"@type\":\"CommentAction\",\"name\":\"Comment\",\"target\":[\"https:\/\/www.couchbase.com\/blog\/how-to-migrate-from-couchbase-server-to-couchbase-capella\/#respond\"]}]},{\"@type\":\"WebPage\",\"@id\":\"https:\/\/www.couchbase.com\/blog\/how-to-migrate-from-couchbase-server-to-couchbase-capella\/\",\"url\":\"https:\/\/www.couchbase.com\/blog\/how-to-migrate-from-couchbase-server-to-couchbase-capella\/\",\"name\":\"Couchbase Server to Couchbase Capella Migration Steps\",\"isPartOf\":{\"@id\":\"https:\/\/www.couchbase.com\/blog\/#website\"},\"primaryImageOfPage\":{\"@id\":\"https:\/\/www.couchbase.com\/blog\/how-to-migrate-from-couchbase-server-to-couchbase-capella\/#primaryimage\"},\"image\":{\"@id\":\"https:\/\/www.couchbase.com\/blog\/how-to-migrate-from-couchbase-server-to-couchbase-capella\/#primaryimage\"},\"thumbnailUrl\":\"https:\/\/www.couchbase.com\/blog\/wp-content\/uploads\/sites\/1\/2022\/06\/blog-capella-migration.png\",\"datePublished\":\"2024-10-16T18:11:37+00:00\",\"dateModified\":\"2025-06-14T04:51:41+00:00\",\"description\":\"This Couchbase blog provides steps you need to take to migrate self-managed Couchbase Server clusters to Couchbase Capella\u2122 Database-as-a-Service (DBaaS).\",\"breadcrumb\":{\"@id\":\"https:\/\/www.couchbase.com\/blog\/how-to-migrate-from-couchbase-server-to-couchbase-capella\/#breadcrumb\"},\"inLanguage\":\"en-US\",\"potentialAction\":[{\"@type\":\"ReadAction\",\"target\":[\"https:\/\/www.couchbase.com\/blog\/how-to-migrate-from-couchbase-server-to-couchbase-capella\/\"]}]},{\"@type\":\"ImageObject\",\"inLanguage\":\"en-US\",\"@id\":\"https:\/\/www.couchbase.com\/blog\/how-to-migrate-from-couchbase-server-to-couchbase-capella\/#primaryimage\",\"url\":\"https:\/\/www.couchbase.com\/blog\/wp-content\/uploads\/sites\/1\/2022\/06\/blog-capella-migration.png\",\"contentUrl\":\"https:\/\/www.couchbase.com\/blog\/wp-content\/uploads\/sites\/1\/2022\/06\/blog-capella-migration.png\",\"width\":2400,\"height\":1256},{\"@type\":\"BreadcrumbList\",\"@id\":\"https:\/\/www.couchbase.com\/blog\/how-to-migrate-from-couchbase-server-to-couchbase-capella\/#breadcrumb\",\"itemListElement\":[{\"@type\":\"ListItem\",\"position\":1,\"name\":\"Home\",\"item\":\"https:\/\/www.couchbase.com\/blog\/\"},{\"@type\":\"ListItem\",\"position\":2,\"name\":\"How To Migrate From Couchbase Server to Couchbase Capella\"}]},{\"@type\":\"WebSite\",\"@id\":\"https:\/\/www.couchbase.com\/blog\/#website\",\"url\":\"https:\/\/www.couchbase.com\/blog\/\",\"name\":\"The Couchbase Blog\",\"description\":\"Couchbase, the NoSQL Database\",\"publisher\":{\"@id\":\"https:\/\/www.couchbase.com\/blog\/#organization\"},\"potentialAction\":[{\"@type\":\"SearchAction\",\"target\":{\"@type\":\"EntryPoint\",\"urlTemplate\":\"https:\/\/www.couchbase.com\/blog\/?s={search_term_string}\"},\"query-input\":{\"@type\":\"PropertyValueSpecification\",\"valueRequired\":true,\"valueName\":\"search_term_string\"}}],\"inLanguage\":\"en-US\"},{\"@type\":\"Organization\",\"@id\":\"https:\/\/www.couchbase.com\/blog\/#organization\",\"name\":\"The Couchbase Blog\",\"url\":\"https:\/\/www.couchbase.com\/blog\/\",\"logo\":{\"@type\":\"ImageObject\",\"inLanguage\":\"en-US\",\"@id\":\"https:\/\/www.couchbase.com\/blog\/#\/schema\/logo\/image\/\",\"url\":\"https:\/\/www.couchbase.com\/blog\/wp-content\/uploads\/2023\/04\/admin-logo.png\",\"contentUrl\":\"https:\/\/www.couchbase.com\/blog\/wp-content\/uploads\/2023\/04\/admin-logo.png\",\"width\":218,\"height\":34,\"caption\":\"The Couchbase Blog\"},\"image\":{\"@id\":\"https:\/\/www.couchbase.com\/blog\/#\/schema\/logo\/image\/\"}},{\"@type\":\"Person\",\"@id\":\"https:\/\/www.couchbase.com\/blog\/#\/schema\/person\/befa2a9de827aed2f8354f939cd6598e\",\"name\":\"Couchbase Product Marketing\",\"image\":{\"@type\":\"ImageObject\",\"inLanguage\":\"en-US\",\"@id\":\"https:\/\/www.couchbase.com\/blog\/#\/schema\/person\/image\/5112ed57023bd2807ae7086c2fe68752\",\"url\":\"https:\/\/secure.gravatar.com\/avatar\/4760a19fc4ed6b8b830ba98f0869ed0d8ee6729e2593881e1a68032b9c281d5d?s=96&d=mm&r=g\",\"contentUrl\":\"https:\/\/secure.gravatar.com\/avatar\/4760a19fc4ed6b8b830ba98f0869ed0d8ee6729e2593881e1a68032b9c281d5d?s=96&d=mm&r=g\",\"caption\":\"Couchbase Product Marketing\"},\"url\":\"https:\/\/www.couchbase.com\/blog\/author\/couchbase-pmm\/\"}]}<\/script>\n<!-- \/ Yoast SEO Premium plugin. -->","yoast_head_json":{"title":"Couchbase Server to Couchbase Capella Migration Steps","description":"This Couchbase blog provides steps you need to take to migrate self-managed Couchbase Server clusters to Couchbase Capella\u2122 Database-as-a-Service (DBaaS).","robots":{"index":"index","follow":"follow","max-snippet":"max-snippet:-1","max-image-preview":"max-image-preview:large","max-video-preview":"max-video-preview:-1"},"canonical":"https:\/\/www.couchbase.com\/blog\/how-to-migrate-from-couchbase-server-to-couchbase-capella\/","og_locale":"en_US","og_type":"article","og_title":"How To Migrate From Couchbase Server to Couchbase Capella","og_description":"This Couchbase blog provides steps you need to take to migrate self-managed Couchbase Server clusters to Couchbase Capella\u2122 Database-as-a-Service (DBaaS).","og_url":"https:\/\/www.couchbase.com\/blog\/how-to-migrate-from-couchbase-server-to-couchbase-capella\/","og_site_name":"The Couchbase Blog","article_published_time":"2024-10-16T18:11:37+00:00","article_modified_time":"2025-06-14T04:51:41+00:00","og_image":[{"width":1024,"height":536,"url":"https:\/\/www.couchbase.com\/blog\/wp-content\/uploads\/sites\/1\/2022\/06\/blog-capella-migration-1024x536.png","type":"image\/png"}],"author":"Couchbase Product Marketing","twitter_card":"summary_large_image","twitter_misc":{"Written by":"Couchbase Product Marketing","Est. reading time":"16 minutes"},"schema":{"@context":"https:\/\/schema.org","@graph":[{"@type":"Article","@id":"https:\/\/www.couchbase.com\/blog\/how-to-migrate-from-couchbase-server-to-couchbase-capella\/#article","isPartOf":{"@id":"https:\/\/www.couchbase.com\/blog\/how-to-migrate-from-couchbase-server-to-couchbase-capella\/"},"author":{"name":"Couchbase Product Marketing","@id":"https:\/\/www.couchbase.com\/blog\/#\/schema\/person\/befa2a9de827aed2f8354f939cd6598e"},"headline":"How To Migrate From Couchbase Server to Couchbase Capella","datePublished":"2024-10-16T18:11:37+00:00","dateModified":"2025-06-14T04:51:41+00:00","mainEntityOfPage":{"@id":"https:\/\/www.couchbase.com\/blog\/how-to-migrate-from-couchbase-server-to-couchbase-capella\/"},"wordCount":3603,"commentCount":0,"publisher":{"@id":"https:\/\/www.couchbase.com\/blog\/#organization"},"image":{"@id":"https:\/\/www.couchbase.com\/blog\/how-to-migrate-from-couchbase-server-to-couchbase-capella\/#primaryimage"},"thumbnailUrl":"https:\/\/www.couchbase.com\/blog\/wp-content\/uploads\/sites\/1\/2022\/06\/blog-capella-migration.png","keywords":["cbbackupmgr","database migration"],"articleSection":["Couchbase Capella","Couchbase Server","Cross Data Center Replication (XDCR)"],"inLanguage":"en-US","potentialAction":[{"@type":"CommentAction","name":"Comment","target":["https:\/\/www.couchbase.com\/blog\/how-to-migrate-from-couchbase-server-to-couchbase-capella\/#respond"]}]},{"@type":"WebPage","@id":"https:\/\/www.couchbase.com\/blog\/how-to-migrate-from-couchbase-server-to-couchbase-capella\/","url":"https:\/\/www.couchbase.com\/blog\/how-to-migrate-from-couchbase-server-to-couchbase-capella\/","name":"Couchbase Server to Couchbase Capella Migration Steps","isPartOf":{"@id":"https:\/\/www.couchbase.com\/blog\/#website"},"primaryImageOfPage":{"@id":"https:\/\/www.couchbase.com\/blog\/how-to-migrate-from-couchbase-server-to-couchbase-capella\/#primaryimage"},"image":{"@id":"https:\/\/www.couchbase.com\/blog\/how-to-migrate-from-couchbase-server-to-couchbase-capella\/#primaryimage"},"thumbnailUrl":"https:\/\/www.couchbase.com\/blog\/wp-content\/uploads\/sites\/1\/2022\/06\/blog-capella-migration.png","datePublished":"2024-10-16T18:11:37+00:00","dateModified":"2025-06-14T04:51:41+00:00","description":"This Couchbase blog provides steps you need to take to migrate self-managed Couchbase Server clusters to Couchbase Capella\u2122 Database-as-a-Service (DBaaS).","breadcrumb":{"@id":"https:\/\/www.couchbase.com\/blog\/how-to-migrate-from-couchbase-server-to-couchbase-capella\/#breadcrumb"},"inLanguage":"en-US","potentialAction":[{"@type":"ReadAction","target":["https:\/\/www.couchbase.com\/blog\/how-to-migrate-from-couchbase-server-to-couchbase-capella\/"]}]},{"@type":"ImageObject","inLanguage":"en-US","@id":"https:\/\/www.couchbase.com\/blog\/how-to-migrate-from-couchbase-server-to-couchbase-capella\/#primaryimage","url":"https:\/\/www.couchbase.com\/blog\/wp-content\/uploads\/sites\/1\/2022\/06\/blog-capella-migration.png","contentUrl":"https:\/\/www.couchbase.com\/blog\/wp-content\/uploads\/sites\/1\/2022\/06\/blog-capella-migration.png","width":2400,"height":1256},{"@type":"BreadcrumbList","@id":"https:\/\/www.couchbase.com\/blog\/how-to-migrate-from-couchbase-server-to-couchbase-capella\/#breadcrumb","itemListElement":[{"@type":"ListItem","position":1,"name":"Home","item":"https:\/\/www.couchbase.com\/blog\/"},{"@type":"ListItem","position":2,"name":"How To Migrate From Couchbase Server to Couchbase Capella"}]},{"@type":"WebSite","@id":"https:\/\/www.couchbase.com\/blog\/#website","url":"https:\/\/www.couchbase.com\/blog\/","name":"The Couchbase Blog","description":"Couchbase, the NoSQL Database","publisher":{"@id":"https:\/\/www.couchbase.com\/blog\/#organization"},"potentialAction":[{"@type":"SearchAction","target":{"@type":"EntryPoint","urlTemplate":"https:\/\/www.couchbase.com\/blog\/?s={search_term_string}"},"query-input":{"@type":"PropertyValueSpecification","valueRequired":true,"valueName":"search_term_string"}}],"inLanguage":"en-US"},{"@type":"Organization","@id":"https:\/\/www.couchbase.com\/blog\/#organization","name":"The Couchbase Blog","url":"https:\/\/www.couchbase.com\/blog\/","logo":{"@type":"ImageObject","inLanguage":"en-US","@id":"https:\/\/www.couchbase.com\/blog\/#\/schema\/logo\/image\/","url":"https:\/\/www.couchbase.com\/blog\/wp-content\/uploads\/2023\/04\/admin-logo.png","contentUrl":"https:\/\/www.couchbase.com\/blog\/wp-content\/uploads\/2023\/04\/admin-logo.png","width":218,"height":34,"caption":"The Couchbase Blog"},"image":{"@id":"https:\/\/www.couchbase.com\/blog\/#\/schema\/logo\/image\/"}},{"@type":"Person","@id":"https:\/\/www.couchbase.com\/blog\/#\/schema\/person\/befa2a9de827aed2f8354f939cd6598e","name":"Couchbase Product Marketing","image":{"@type":"ImageObject","inLanguage":"en-US","@id":"https:\/\/www.couchbase.com\/blog\/#\/schema\/person\/image\/5112ed57023bd2807ae7086c2fe68752","url":"https:\/\/secure.gravatar.com\/avatar\/4760a19fc4ed6b8b830ba98f0869ed0d8ee6729e2593881e1a68032b9c281d5d?s=96&d=mm&r=g","contentUrl":"https:\/\/secure.gravatar.com\/avatar\/4760a19fc4ed6b8b830ba98f0869ed0d8ee6729e2593881e1a68032b9c281d5d?s=96&d=mm&r=g","caption":"Couchbase Product Marketing"},"url":"https:\/\/www.couchbase.com\/blog\/author\/couchbase-pmm\/"}]}},"authors":[{"term_id":9657,"user_id":82066,"is_guest":0,"slug":"couchbase-pmm","display_name":"Couchbase Product Marketing","avatar_url":{"url":"https:\/\/www.couchbase.com\/blog\/wp-content\/uploads\/sites\/1\/2022\/06\/image_2022-06-17_105452255.png","url2x":"https:\/\/www.couchbase.com\/blog\/wp-content\/uploads\/sites\/1\/2022\/06\/image_2022-06-17_105452255.png"},"author_category":"","last_name":"","first_name":"Couchbase Product Marketing","job_title":"","user_url":"","description":""}],"_links":{"self":[{"href":"https:\/\/www.couchbase.com\/blog\/wp-json\/wp\/v2\/posts\/13413","targetHints":{"allow":["GET"]}}],"collection":[{"href":"https:\/\/www.couchbase.com\/blog\/wp-json\/wp\/v2\/posts"}],"about":[{"href":"https:\/\/www.couchbase.com\/blog\/wp-json\/wp\/v2\/types\/post"}],"author":[{"embeddable":true,"href":"https:\/\/www.couchbase.com\/blog\/wp-json\/wp\/v2\/users\/82066"}],"replies":[{"embeddable":true,"href":"https:\/\/www.couchbase.com\/blog\/wp-json\/wp\/v2\/comments?post=13413"}],"version-history":[{"count":0,"href":"https:\/\/www.couchbase.com\/blog\/wp-json\/wp\/v2\/posts\/13413\/revisions"}],"wp:featuredmedia":[{"embeddable":true,"href":"https:\/\/www.couchbase.com\/blog\/wp-json\/wp\/v2\/media\/16453"}],"wp:attachment":[{"href":"https:\/\/www.couchbase.com\/blog\/wp-json\/wp\/v2\/media?parent=13413"}],"wp:term":[{"taxonomy":"category","embeddable":true,"href":"https:\/\/www.couchbase.com\/blog\/wp-json\/wp\/v2\/categories?post=13413"},{"taxonomy":"post_tag","embeddable":true,"href":"https:\/\/www.couchbase.com\/blog\/wp-json\/wp\/v2\/tags?post=13413"},{"taxonomy":"author","embeddable":true,"href":"https:\/\/www.couchbase.com\/blog\/wp-json\/wp\/v2\/ppma_author?post=13413"}],"curies":[{"name":"wp","href":"https:\/\/api.w.org\/{rel}","templated":true}]}}