{"id":2207,"date":"2024-10-16T11:11:37","date_gmt":"2024-10-16T18:11:37","guid":{"rendered":"https:\/\/www.couchbase.com\/blog\/how-to-migrate-from-couchbase-server-to-couchbase-capella\/"},"modified":"2024-10-16T11:11:37","modified_gmt":"2024-10-16T18:11:37","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":"\n<p><strong>Steps to migrate self-managed Couchbase Server clusters to Couchbase Capella\u2122 Database-as-a-Service (DBaaS)<\/strong><\/p>\n\n\n\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>Couchbase Capella<\/span><\/a><span> 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\n\n\n<h2 class=\"wp-block-heading\">Why migrate?<\/h2>\n\n\n\n<p><span>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\n\n\n<p><span>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\n\n\n<h3 class=\"wp-block-heading\">Prerequisites<b>\u00a0<\/b><\/h3>\n\n\n\n<ul class=\"wp-block-list\">\n<li><span>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>\n<ul>\n<li><span>Follow the instructions in the <\/span><a href=\"https:\/\/docs.couchbase.com\/tutorials\/dbaas-self-service\/index.html\" target=\"_blank\" rel=\"noopener\"><span>Getting Started with Couchbase Capella<\/span><\/a><span> tutorial to get started<\/span><\/li>\n<li>Note: <span>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>Capella documentation<\/span><\/a><\/li>\n<\/ul>\n<\/li>\n\n\n<li><span>An existing self-managed Couchbase Server environment either on premises or deployed on a cloud service provider<\/span><\/li>\n\n\n<li>It is assumed that you already have:\n<ul>\n<li><span>Familiarity with administering Couchbase Server and Couchbase Capella<\/span><\/li>\n<li><span>Familiarity with running commands in a command line interface (CLI)<\/span><\/li>\n<\/ul>\n<\/li>\n\n<\/ul>\n\n\n\n<h3 class=\"wp-block-heading\">Limitations<\/h3>\n\n\n\n<p><span>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>Couchbase Eventing Service<\/span><\/a><span>, <\/span><a href=\"https:\/\/docs.couchbase.com\/server\/current\/fts\/fts-introduction.html\" target=\"_blank\" rel=\"noopener\"><span>Couchbase Full-Text Search<\/span><\/a><span> (FTS) indexes or <\/span><a href=\"https:\/\/docs.couchbase.com\/server\/current\/analytics\/introduction.html\" target=\"_blank\" rel=\"noopener\"><span>Couchbase Analytics<\/span><\/a><span>.<\/span><\/p>\n\n\n\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\n\n\n<h3 class=\"wp-block-heading\">Utilities<\/h3>\n\n\n\n<ul class=\"wp-block-list\">\n<li><a href=\"https:\/\/docs.couchbase.com\/server\/current\/backup-restore\/enterprise-backup-restore.html\" target=\"_blank\" rel=\"noopener\"><span>Couchbase cbbackupmgr<\/span><\/a><span> &#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><span>Enterprise Edition version 6.6, version 7.x<\/span><\/li>\n<li><span>Community Edition version 7.x<\/span><\/li>\n<li><span>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\n\n<li><a href=\"https:\/\/docs.couchbase.com\/server\/current\/cli\/cbtools\/cbbackup.html\" target=\"_blank\" rel=\"noopener\"><span>Couchbase cbbackup<\/span><\/a><span> and <\/span><a href=\"https:\/\/docs.couchbase.com\/server\/current\/cli\/cbtools\/cbrestore.html\" target=\"_blank\" rel=\"noopener\"><span>cbrestore<\/span><\/a><span> &#8211; are CLI tools used for migrating data from the following version of self-managed Couchbase Server to Capella:<\/span>\n<ul>\n<li><span>Community Edition version 6.6<\/span><\/li>\n<li><span>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\n\n<li><a href=\"https:\/\/docs.couchbase.com\/cloud\/current\/clusters\/xdcr\/xdcr.html\" target=\"_blank\" rel=\"noopener\"><span>Couchbase XDCR<\/span><\/a><span> \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\n<\/ul>\n\n\n\n<p><b>Note:\u00a0<\/b><span>XDCR cannot be used with Couchbase Server Community Edition or Capella Free Tier<\/span><\/p>\n\n\n\n<hr class=\"wp-block-separator has-alpha-channel-opacity\"\/>\n\n\n\n<p><span>The <\/span><b>Prepare for migrating<\/b><span>\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>contact Couchbase<\/span><\/a><span>.<\/span><\/p>\n\n\n\n<hr class=\"wp-block-separator has-alpha-channel-opacity\"\/>\n\n\n\n<h2 class=\"wp-block-heading\">Prepare for migrating<\/h2>\n\n\n\n<p><span>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> section of the Couchbase Capella UI and then choose <\/span><b>Add Activation ID<\/b><span>.<\/span><\/p>\n\n\n\n<p><b><i>Review your self-managed Couchbase Server cluster:<\/i><\/b><\/p>\n\n\n\n<ul class=\"wp-block-list\">\n<li><span>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>Couchbase Server Web Console<\/span><\/a><span> and assess your cluster\u2019s nodes and buckets<\/span><\/li>\n\n\n<li><span>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\n\n<li><span>Record the memory and storage for each individual node<\/span><\/li>\n\n\n<li><span>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\n\n<li><span>Record the RAM quota and conflict resolution setting for each bucket<\/span><\/li>\n\n\n<li><span>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\n<\/ul>\n\n\n\n<p><span>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\n\n\n<p><b><i>Note the Couchbase Service distribution on the self-managed Couchbase Server cluster:<\/i><\/b><\/p>\n\n\n\n<ul class=\"wp-block-list\">\n<li><span>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\n\n<li><span>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>Data Service<\/span><\/a><span>, <\/span><a href=\"https:\/\/docs.couchbase.com\/server\/current\/learn\/services-and-indexes\/services\/query-service.html\"><span>Query Service<\/span><\/a><span>, <\/span><a href=\"https:\/\/docs.couchbase.com\/server\/current\/learn\/services-and-indexes\/services\/index-service.html\"><span>Index Service<\/span><\/a><span>, <\/span><a href=\"https:\/\/docs.couchbase.com\/server\/current\/learn\/services-and-indexes\/services\/search-service.html\"><span>Search Service<\/span><\/a><span>, <\/span><a href=\"https:\/\/docs.couchbase.com\/server\/current\/learn\/services-and-indexes\/services\/analytics-service.html\"><span>Analytics Service<\/span><\/a><span>, and <\/span><a href=\"https:\/\/docs.couchbase.com\/server\/current\/learn\/services-and-indexes\/services\/eventing-service.html\"><span>Eventing Service<\/span><\/a><span>)<\/span><\/li>\n\n<\/ul>\n\n\n\n<p><b><i>Record the IP addresses of the self-managed Couchbase Server cluster nodes:<\/i><\/b><\/p>\n\n\n\n<p><i>Skip this step if you are using Community Edition<\/i><\/p>\n\n\n\n<ul class=\"wp-block-list\">\n<li><span>Record the IP address for each node in your cluster, this is for whitelisting them on your Couchbase Capella cluster later.<\/span><\/li>\n\n\n<li><i><span>TIP<\/span><\/i><span>: To get the IP of each node in your self managed cluster:<\/span>\n<ul>\n<li><span>SSH into the node<\/span><\/li>\n<li><span>Issue this command: <\/span><em><span><code>dig +short myip.opendns.com @resolver1.opendns.com<\/code><\/span><\/em><\/li>\n<\/ul>\n<\/li>\n\n<\/ul>\n\n\n\n<h2 class=\"wp-block-heading\">Deploy and configure a cluster on Couchbase Capella<\/h2>\n\n\n\n<p><i><\/i><b><i>Create and configure a cluster on Couchbase Capella:<\/i><\/b><\/p>\n\n\n\n<ul class=\"wp-block-list\">\n<li><span>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\n\n<li><span>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\n\n<li><span>If you don\u2019t find an appropriate template, choose <strong>Custom Template<\/strong> in the <strong>Cluster Sizing<\/strong> editor<\/span><\/li>\n\n\n<li><span>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\n\n<li><span>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>Create a cluster<\/span><\/a><span> in the Couchbase Capella documentation<\/span><\/li>\n\n<\/ul>\n\n\n\n<p><span>Couchbase Capella uses <\/span><a href=\"https:\/\/docs.couchbase.com\/cloud\/clusters\/scale-cluster.html#scale-a-cluster\"><span>multi-dimensional scaling<\/span><\/a><span> guidelines, and services and nodes can only be chosen according to deployment guidelines.<\/span><\/p>\n\n\n\n<p><b><i>Create a database credentials user:<\/i><\/b><\/p>\n\n\n\n<ul class=\"wp-block-list\">\n<li><span>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\n\n<li><span>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>Configure database credentials<\/span><\/a><span> from the Couchbase Capella documentation<\/span><\/li>\n\n<\/ul>\n\n\n\n<p><b><i>Record Couchbase Capella cluster connection endpoint and add IP address as \u201cAllowed IP\u201d.<\/i><\/b><\/p>\n\n\n\n<p><b><i>Save Root Certificates for self-managed Couchbase Server and Couchbase Capella:<\/i><\/b><\/p>\n\n\n\n<ul class=\"wp-block-list\">\n<li><span>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\n\n<li><span>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\n\n<li><span>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\n<\/ul>\n\n\n\n<p><span>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>Configure allowed IP addresses<\/span><\/a><span> in the Couchbase documentation.<\/span><\/p>\n\n\n\n<p><b>Note:<\/b><span> 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\n\n\n<p><span>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\n\n\n<p><span>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>Root certificate<\/span><\/a><span> in the Couchbase Server documentation.<\/span><\/p>\n\n\n\n<p><b><i>Create target buckets on Couchbase Capella:<\/i><\/b><\/p>\n\n\n\n<ul class=\"wp-block-list\">\n<li><span>Log in to the Couchbase Capella UI<\/span><\/li>\n\n\n<li><span>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>Create a bucket<\/span><\/a><span> in the Couchbase Capella documentation<\/span><\/li>\n\n<\/ul>\n\n\n\n<p><b>Important:<\/b><span> Bucket names cannot contain an underscore.<\/span><\/p>\n\n\n\n<h2 class=\"wp-block-heading\">Migrate using cbbackupmgr &#8211; option 1<\/h2>\n\n\n\n<p><b>This option applies to the following versions of self-managed Couchbase Server:<\/b><\/p>\n\n\n\n<ul class=\"wp-block-list\">\n<li><span>Enterprise Edition version 6.6, version 7.0.x, version 7.1<\/span><\/li>\n\n\n<li><span>Community Edition version 7.0.x, version 7.1<\/span><\/li>\n\n<\/ul>\n\n\n\n<p><b><i>Use cbbackupmgr CLI tool:<\/i><\/b><\/p>\n\n\n\n<ul class=\"wp-block-list\">\n<li><span><em>cbbackupmgr<\/em> is located in the root directory of your self-managed Couchbase Server installation.<\/span><\/li>\n\n\n<li><span>You use a command line terminal to work with cbbackupmgr.<\/span><\/li>\n\n<\/ul>\n\n\n\n<p><span>Depending on the platform, cbbackupmgr is installed with Couchbase Server in the following location:<\/span><\/p>\n\n\n\n<ul class=\"wp-block-list\">\n<li><strong>Linux: <\/strong><em><span>\/opt\/couchbase\/bin\/cbbackupmgr<\/span><\/em><\/li>\n\n\n<li><strong>Windows<\/strong> (assuming default installation):\u00a0<i>C:Program FilesCouchbaseServerbincbbackupmgr<\/i><\/li>\n\n\n<li><strong>Mac OS X: <\/strong>\/Applications\/Couchbase <i>Server.app\/Contents\/Resources\/couchbase-core\/bin\/cbbackupmgr<\/i><\/li>\n\n<\/ul>\n\n\n\n<p><strong><i>TIP<\/i><\/strong><span>: 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>downloading Couchbase Server<\/span><\/a><span> and installing it on your local system.<\/span><\/p>\n\n\n\n<h3 class=\"wp-block-heading\">Create a backup repository on the self-managed Couchbase Server system<\/h3>\n\n\n\n<ul class=\"wp-block-list\">\n<li><span>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\n\n<li><span>The following command will create the directory in your systems root folder: <\/span><em><span><code>mkdir \/backups\/<\/code><\/span><\/em><\/li>\n\n\n<li><span>Run the following cbbackupmgr command to create a repository in the new directory, replacing <\/span><span><code>&lt;SELF-MANAGED-BUCKET-NAME&gt;<\/code><\/span><span><span>\u00a0with the actual name of the bucket you wish to migrate:<br>\n<\/span><\/span>\n<p><p>[crayon nums=&#8221;false&#8221; wrap=&#8221;true&#8221; lang=&#8221;default&#8221; decode=&#8221;true&#8221;]cbbackupmgr config &#8211;archive \/backups\/ &#8211;repo &lt;SELF-MANAGED-BUCKET-NAME&gt; &#8211;disable-eventing &#8211;disable-analytics &#8211;disable-cluster-analytics &#8211;disable-bucket-query &#8211;disable-cluster-query &#8211;include-data &lt;SELF-MANAGED-BUCKET-NAME&gt;[\/crayon]<\/p>\n<\/p>\n<\/li>\n\n<\/ul>\n\n\n\n<p>NOTE:<\/p>\n\n\n\n<ul class=\"wp-block-list\">\n<li><span>This Repository backs up only the specified bucket<\/span><\/li>\n\n\n<li><span>Analytics and Eventing are explicitly disabled<\/span><\/li>\n\n<\/ul>\n\n\n\n<p><span>Run the following command to examine the repo:<\/span><\/p>\n\n\n<p>[crayon nums=&#8221;false&#8221; lang=&#8221;default&#8221; decode=&#8221;true&#8221;]cbbackupmgr info -a \/backups -all[\/crayon]<\/p>\n\n\n\n<p><span>Basic information about your repository will be displayed.<\/span><\/p>\n\n\n\n<h3 class=\"wp-block-heading\">Backup the self-managed Couchbase Server bucket<\/h3>\n\n\n\n<p><span>Run the following command to create the backup:<\/span><\/p>\n\n\n<p>[crayon nums=&#8221;false&#8221; wrap=&#8221;true&#8221; decode-attributes=&#8221;false&#8221; lang=&#8221;default&#8221; decode=&#8221;true&#8221;]cbbackupmgr backup &#8211;archive \/backups &#8211;repo &lt;SELF-MANAGED-BUCKET-NAME&gt; &#8211;cluster couchbases:\/\/&lt;SELF-MANAGED-SERVER-URL&gt; &#8211;username &lt;SELF-MANAGED-SERVER-ADMIN&gt; &#8211;password &lt;SELF-MANAGED-SERVER-ADMIN-PWD&gt; &#8211;cacert &lt;FULL-PATH-TO-SELF-MANAGED-ROOT-CERT&gt; &#8211;full-backup[\/crayon]<\/p>\n\n\n\n<p><span>Note: Make the following substitutions in the command:<\/span><\/p>\n\n\n\n<ul class=\"wp-block-list\">\n<li><span>Replace <\/span><em><span><code>&lt;SELF-MANAGED-BUCKET-NAME&gt;<\/code><\/span><\/em><span>\u00a0with the actual name of the bucket you wish to migrate<\/span><\/li>\n\n\n<li><span>Replace <\/span><em><span><code>&lt;SELF-MANAGED-SERVER-ADMIN&gt;<\/code> <\/span><\/em><span>with the administrator user name on the self-managed Couchbase Server<\/span><\/li>\n\n\n<li><span>Replace <\/span><span><em><code>&lt;SELF-MANAGED-SERVER-ADMIN-PWD<\/code><\/em>&gt;<\/span><span>\u00a0with the administrator password on the self-managed Couchbase Server<\/span><\/li>\n\n\n<li><span>Replace <\/span><em><span><code>&lt;FULL-PATH-TO-SELF-MANAGED-ROOT-CERT&gt;<\/code><\/span><\/em><span>\u00a0with the full file path to the self-managed Couchbase Server root certificate (as saved in earlier step)<\/span><\/li>\n\n<\/ul>\n\n\n\n<p><span>An example command would look like:<\/span><\/p>\n\n\n<p>[crayon nums=&#8221;false&#8221; wrap=&#8221;true&#8221; decode-attributes=&#8221;false&#8221; lang=&#8221;default&#8221; decode=&#8221;true&#8221;]cbbackupmgr backup &#8211;archive \/backups &#8211;repo samplebucket &#8211;cluster couchbases:\/\/127.0.0.1 &#8211;username Administrator &#8211;password A5121U!i &#8211;cacert \/ROOT_CERT\/root-certificate.pem &#8211;full-backup[\/crayon]<\/p>\n\n\n\n<p><span>Output from the command will be like:<\/span><\/p>\n\n\n\n<p><img loading=\"lazy\" decoding=\"async\" class=\"alignnone size-large wp-image-13415\" src=\"https:\/\/www.couchbase.com\/wp-content\/uploads\/sites\/5\/2026\/05\/image1-3-1024x314-1.png\" alt=\"cbbackupmgr output displayed\" width=\"900\" height=\"276\"><\/p>\n\n\n\n<p><span>Examine the backup using the command:<\/span><\/p>\n\n\n<p>[crayon nums=&#8221;false&#8221; wrap=&#8221;true&#8221; lang=&#8221;default&#8221; decode=&#8221;true&#8221;]cbbackupmgr info -a \/backups -all[\/crayon]<\/p>\n\n\n\n<p><span>Basic information about your backup will be displayed.<\/span><\/p>\n\n\n\n<h3 class=\"wp-block-heading\">Restore the backed up self-managed bucket to Capella<\/h3>\n\n\n\n<p><span>In the command line terminal, use the following command to restore the backed up self-managed bucket to Capella:<\/span><\/p>\n\n\n<p>[crayon nums=&#8221;false&#8221; wrap=&#8221;true&#8221; decode-attributes=&#8221;false&#8221; lang=&#8221;default&#8221; decode=&#8221;true&#8221;]cbbackupmgr restore &#8211;archive \/backups &#8211;repo &lt;SELF-MANAGED-BUCKET-NAME&gt; &#8211;cluster couchbases:\/\/&lt;CAPELLA-ENDPOINT&gt; &#8211;username &lt;CAPELLA-DATABASE-CREDENTIALS-USER&gt; &#8211;password &lt;CAPELLA-DATABASE-CREDENTIALS-PASSWORD&gt; &#8211;cacert &lt;FULL-PATH-TO-CAPELLA-ROOT-CERT&gt;[\/crayon]<\/p>\n\n\n\n<p><span>Note: make the following substitutions in the command:<\/span><\/p>\n\n\n\n<ul class=\"wp-block-list\">\n<li><span>Replace <\/span><em><span><code>&lt;SELF-MANAGED-BUCKET-NAME&gt;<\/code><\/span><\/em><span>\u00a0with the actual name of the bucket you with to migrate<\/span><\/li>\n\n\n<li><span>Replace <\/span><em><span><code>&lt;CAPELLA-ENDPOINT&gt;<\/code><\/span><\/em><span> with the Capella cluster endpoint url recorded earlier<\/span>\n<ul>\n<li><span>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><span>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\n\n<li><span>Replace <\/span><em><span><code>&lt;CAPELLA-DATABASE-CREDENTIALS-USER&gt;<\/code><\/span><\/em><span><em>\u00a0<\/em>with the database credentials user on the Capella cluster<\/span><\/li>\n\n\n<li><span>Replace <\/span><span><em><code>&lt;CAPELLA-DATABASE-CREDENTIALS-PASSWORD&gt;<\/code><\/em> <\/span><span>with the database credentials user password<\/span><\/li>\n\n\n<li><span>Replace <\/span><em><span><code>&lt;FULL-PATH-TO-CAPELLA-ROOT-CERT&gt;<\/code><\/span><\/em><span>\u00a0with the full file path to the Capella cluster root certificate (as saved in earlier step).<\/span><\/li>\n\n<\/ul>\n\n\n\n<p><span>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>Restore completed successfully<\/span><\/em><span>\u201d<\/span><\/p>\n\n\n\n<h3 class=\"wp-block-heading\">Examine the migrated documents and indexes<\/h3>\n\n\n\n<ul class=\"wp-block-list\">\n<li><span>In the Couchbase Capella UI, choose <strong>Tools &gt; Documents<\/strong> for your target cluster<\/span><\/li>\n\n\n<li><span>You should see that all of your self-managed cluster documents have been migrated to Capella<\/span><\/li>\n\n\n<li><span>In the Couchbase Capella UI, choose <strong>Tools &gt; Indexes<\/strong> for your target cluster<\/span><\/li>\n\n\n<li><span>You should see that all of your self-managed cluster indexes have been migrated to Capella<\/span><\/li>\n\n<\/ul>\n\n\n\n<p><span><strong>NOTE<\/strong>: Any indexes with definitions set as <\/span><em><span><code>defer_build:true<\/code> <\/span><\/em><span>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\n\n\n<h3 class=\"wp-block-heading\">Build indexes on Capella<\/h3>\n\n\n\n<ul class=\"wp-block-list\">\n<li><span>In the Couchbase Capella UI, choose <strong>Tools &gt; Query Workbench<\/strong> for your target cluster<\/span><\/li>\n\n\n<li><span>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\n<\/ul>\n\n\n<p>[crayon decode-attributes=&#8221;false&#8221; lang=&#8221;default&#8221; decode=&#8221;true&#8221;]SELECT RAW CONCAT(&#8220;BUILD INDEX ON &#8220;, k ,\u00a0 &#8220;([&#8216;&#8221;, CONCAT2 (&#8220;&#8216;,'&#8221;, inames), &#8220;&#8216;]);&#8221;)<br \/>\nFROM system:indexes AS s<br \/>\nLET bid = CONCAT(&#8220;`&#8221;,s.bucket_id, &#8220;`&#8221;),<br \/>\n\u00a0\u00a0\u00a0\u00a0sid = CONCAT(&#8220;`&#8221;, s.scope_id, &#8220;`&#8221;),<br \/>\n\u00a0\u00a0\u00a0\u00a0kid = CONCAT(&#8220;`&#8221;, s.keyspace_id, &#8220;`&#8221;),<br \/>\n\u00a0\u00a0\u00a0\u00a0k = NVL2(bid, CONCAT2(&#8220;.&#8221;, bid, sid, kid), kid)<br \/>\nWHERE s.namespace_id = &#8220;default&#8221;<br \/>\nGROUP BY k<br \/>\nLETTING inames = ARRAY_AGG(s.name) FILTER (WHERE s.state = &#8216;deferred&#8217;)<br \/>\nHAVING ARRAY_LENGTH(inames) &gt; 0;[\/crayon]<\/p>\n\n\n\n<p><span>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\n\n<p>[crayon decode-attributes=&#8221;false&#8221; lang=&#8221;default&#8221; decode=&#8221;true&#8221;][<br \/>\n\u00a0\u00a0&#8220;BUILD INDEX ON `couchmusic2`.`music`.`subregions`([&#8216;region&#8217;]);&#8221;,<br \/>\n\u00a0\u00a0&#8220;BUILD INDEX ON `couchmusic2`.`music`.`countries`([&#8216;country_code&#8217;,&#8217;country_region_number&#8217;]);&#8221;<br \/>\n][\/crayon]<\/p>\n\n\n\n<p><span>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\n\n\n<p><span>Congratulations, you have just migrated data and indexes from your self-managed Couchbase Server cluster to Capella!<\/span><\/p>\n\n\n\n<hr class=\"wp-block-separator has-alpha-channel-opacity\"\/>\n\n\n\n<h2 class=\"wp-block-heading\">Migrate using cbbackup and cbrestore &#8211; option 2<\/h2>\n\n\n\n<p><b>This option applies to the following versions of self-managed Couchbase Server:<\/b><\/p>\n\n\n\n<ul class=\"wp-block-list\">\n<li><span>Community Edition version 6.6<\/span><\/li>\n\n<\/ul>\n\n\n\n<p><b><i>Use the cbbackup CLI tool:<\/i><\/b><\/p>\n\n\n\n<ul class=\"wp-block-list\">\n<li><span><em>cbbackup<\/em> is located in the root directory of your self-managed Couchbase Server installation<\/span><\/li>\n\n\n<li><span>You use a command line terminal to work with cbbackup<\/span><\/li>\n\n\n<li><span>Depending on the platform, cbbackup is installed with Couchbase Server in the following location:<\/span>\n<ul>\n<li><span><strong>Linux<\/strong>:\u00a0<\/span><i><span>\/opt\/couchbase\/bin\/cbbackup<\/span><\/i><\/li>\n<li><span><strong>Windows<\/strong> (assuming default installation): <\/span><i>C:Program FilesCouchbaseServerbincbbackup<\/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\n<\/ul>\n\n\n\n<p><span>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>downloading Couchbase Server<\/span><\/a><span> and installing it on your local system.<\/span><\/p>\n\n\n\n<h3 class=\"wp-block-heading\">Create a backup on the self-managed Couchbase Server system<\/h3>\n\n\n\n<p><span>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\n\n\n<p><em><span>mkdir \/backups\/<\/span><\/em><\/p>\n\n\n\n<p><span>Run the following <em>cbbackup<\/em> command to create the backup:<\/span><\/p>\n\n\n<p>[crayon nums=&#8221;false&#8221; wrap=&#8221;true&#8221; decode-attributes=&#8221;false&#8221; lang=&#8221;default&#8221; decode=&#8221;true&#8221;]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;[\/crayon]<\/p>\n\n\n\n<p>M<span>ake the following substitutions in the command:<\/span><\/p>\n\n\n\n<ul class=\"wp-block-list\">\n<li><span>Replace <\/span><em><span><code>&lt;SELF-MANAGED-SERVER-ADMIN&gt;<\/code><\/span><\/em><span>\u00a0with the administrator user name on the self-managed Couchbase Server<\/span><\/li>\n\n\n<li><span>Replace <\/span><em><span><code>&lt;SELF-MANAGED-SERVER-ADMIN-PWD&gt;<\/code> <\/span><\/em><span>with the administrator password on the self-managed Couchbase Server<\/span><\/li>\n\n\n<li><span>Replace <\/span><em><span><code>&lt;URL-TO-SELF-MANAGED-COUCHBASE-SERVER&gt; <\/code><\/span><\/em><span>with the url to your self-managed Couchbase Server<\/span><\/li>\n\n\n<li><span>Replace <\/span><em><span><code>&lt;SELF-MANAGED-BUCKET-NAME&gt;<\/code><\/span><\/em><span> 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\n<\/ul>\n\n\n\n<p><span>Run the following command to examine the backup:<\/span><\/p>\n\n\n\n<ul class=\"wp-block-list\">\n<li><em><span>ls \/backups<\/span><\/em><\/li>\n\n<\/ul>\n\n\n\n<p><span>For Windows use: <\/span><\/p>\n\n\n\n<ul class=\"wp-block-list\">\n<li><em><span>dir \/backups<\/span><\/em><\/li>\n\n<\/ul>\n\n\n\n<p><span>Basic information about your backup will be displayed<\/span><\/p>\n\n\n\n<p><b><i>Use the cbrestore CLI tool:<\/i><\/b><\/p>\n\n\n\n<ul class=\"wp-block-list\">\n<li><span><em>cbrestore<\/em> is located in the root directory of your self-managed Couchbase Server installation.<\/span><\/li>\n\n\n<li><span>You use a command line terminal to work with <em>cbrestore<\/em>.<\/span><\/li>\n\n\n<li><span>Depending on the platform, <em>cbrestore<\/em> is installed with Couchbase Server in the following location:<\/span>\n<ul>\n<li><span><strong>Linux<\/strong>:\u00a0<\/span><i><span>\/opt\/couchbase\/bin\/cbrestore<\/span><\/i><\/li>\n<li><span><strong>Windows<\/strong> (assuming default installation):\u00a0<\/span><i><span>C:Program FilesCouchbaseServerbincbrestore<\/span><\/i><\/li>\n<li><span><strong>Mac OS X<\/strong>:\u00a0<\/span><i><span>\/Applications\/Couchbase Server.app\/Contents\/Resources\/couchbase-core\/bin\/cbrestore<\/span><\/i><\/li>\n<\/ul>\n<\/li>\n\n<\/ul>\n\n\n\n<h3 class=\"wp-block-heading\">Restore the backup to Capella using cbrestore<\/h3>\n\n\n\n<p><span>Run the following <em>cbrestore<\/em> command to restore the backup on Capella:<\/span><\/p>\n\n\n<p>[crayon nums=&#8221;false&#8221; wrap=&#8221;true&#8221; decode-attributes=&#8221;false&#8221; lang=&#8221;default&#8221; decode=&#8221;true&#8221;]cbrestore \/backups https:\/\/&lt;CAPELLA-NODE-HOSTNAME&gt;:18091 &#8211;bucket-source=&lt;SELF-MANAGED-BUCKET-NAME&gt; &#8211;bucket-destination=&lt;CAPELLA-BUCKET-NAME&gt; &#8211;from-date=&lt;DATE-OF-BACKUP&gt; &#8211;to-date=&lt;DATE-FOLLOWING-BACKUP&gt; &#8211;username=&lt;CAPELLA-DATABASE-CREDENTIALS-USER&gt; &#8211;password=&lt;CAPELLA-DATABASE-CREDENTIALS-PASSWORD&gt; &#8211;ssl &#8211;cacert=&lt;FULL-PATH-TO-CAPELLA-ROOT-CERT&gt;[\/crayon]<\/p>\n\n\n\n<p><span>Make the following substitutions in the command:<\/span><\/p>\n\n\n\n<ul class=\"wp-block-list\">\n<li><span>Replace <\/span><em><span><code>&lt;CAPELLA-NODE-HOSTNAME&gt;<\/code><\/span><\/em><span>\u00a0with the node hostname from your Capella cluster (recorded earlier)<\/span><\/li>\n\n\n<li><span>Replace <\/span><em><span><code>&lt;SELF-MANAGED-BUCKET-NAME&gt;<\/code><\/span><\/em><span>\u00a0with the name of the bucket you with to migrate<\/span><\/li>\n\n\n<li><span>Replace <\/span><em><span><code>&lt;CAPELLA-BUCKET-NAME&gt;<\/code><\/span><\/em><span> with the name of the target bucket on Capella<\/span><\/li>\n\n\n<li><span>Replace <\/span><em><span><code>&lt;DATE-OF-BACKUP&gt;<\/code><\/span><\/em><span> with the date that you took the backup<\/span>\n<ul>\n<li><span>NOTE: use the date format <em>YYYY-MM-DD<\/em><\/span><\/li>\n<\/ul>\n<\/li>\n\n\n<li><span>Replace <\/span><em><span><code>&lt;DATE-FOLLOWING-BACKUP&gt;<\/code><\/span><\/em><span> with the date following the date that you took the backup<\/span>\n<ul>\n<li><span>NOTE: use the date format <em>YYYY-MM-DD<\/em><\/span><\/li>\n<\/ul>\n<\/li>\n\n\n<li><span>Replace <\/span><em><span><code>&lt;CAPELLA-DATABASE-CREDENTIALS-USER&gt;<\/code><\/span><\/em><span><em>\u00a0<\/em>with the database credentials user on the Capella cluster<\/span><\/li>\n\n\n<li><span>Replace <\/span><em><span><code>&lt;CAPELLA-DATABASE-CREDENTIALS-PASSWORD&gt;<\/code> <\/span><\/em><span>with the database credentials user password<\/span><\/li>\n\n\n<li><span>Replace <\/span><em><span><code>&lt;FULL-PATH-TO-CAPELLA-ROOT-CERT&gt;<\/code><\/span><\/em><span>\u00a0with the full file path to the Capella cluster root certificate (as saved in earlier step).<\/span><\/li>\n\n<\/ul>\n\n\n\n<p><span>Here is an example of what the command should look like:<\/span><\/p>\n\n\n\n<p><p>[crayon nums=&#8221;false&#8221; lang=&#8221;default&#8221; decode=&#8221;true&#8221;]cbbackupmgr info -a \/backups -all[\/crayon]<\/p>\n0<\/p>\n\n\n\n<p><span>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>Done.<\/span><\/em><\/p>\n\n\n\n<p><b><i>Examine the migrated documents and indexes:<\/i><\/b><\/p>\n\n\n\n<ul class=\"wp-block-list\">\n<li><span>In the Couchbase Capella UI, choose <strong>Tools &gt; Documents<\/strong> for your target cluster<\/span><\/li>\n\n\n<li><span>You should see that all of your self-managed cluster documents have been migrated to Capella<\/span><\/li>\n\n\n<li><span>In the Couchbase Capella UI, choose <strong>Tools &gt; Indexes<\/strong> for your target cluster<\/span><\/li>\n\n\n<li><span>You should see that all of your self-managed cluster indexes have been migrated to Capella<\/span><\/li>\n\n\n<li><span>NOTE: Any indexes with definitions set as <\/span><span><em><code>defer_build:true<\/code><\/em> <\/span><span>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\n<\/ul>\n\n\n\n<h3 class=\"wp-block-heading\">Build indexes on Capella<\/h3>\n\n\n\n<ul class=\"wp-block-list\">\n<li><span>In the Couchbase Capella UI, choose <strong>Tools &gt; Query Workbench<\/strong> in your target cluster<\/span><\/li>\n\n\n<li><span>The following query will create BUILD statements for any indexes that were created but not built during migration.<\/span><\/li>\n\n\n<li><span>Copy\/paste the following query to the Query Workbench in Capella, then click <strong>Execute<\/strong>:<\/span><\/li>\n\n<\/ul>\n\n\n\n<p><p>[crayon nums=&#8221;false&#8221; lang=&#8221;default&#8221; decode=&#8221;true&#8221;]cbbackupmgr info -a \/backups -all[\/crayon]<\/p>\n1<\/p>\n\n\n\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\n\n\n<p><p>[crayon nums=&#8221;false&#8221; lang=&#8221;default&#8221; decode=&#8221;true&#8221;]cbbackupmgr info -a \/backups -all[\/crayon]<\/p>\n2<\/p>\n\n\n\n<p><span>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\n\n\n<p><span>Congratulations, you have just migrated data and indexes from your self-managed Couchbase Server cluster to Capella!<\/span><\/p>\n\n\n\n<hr class=\"wp-block-separator has-alpha-channel-opacity\"\/>\n\n\n\n<h2 class=\"wp-block-heading\">Ongoing migration via Cross Data Center Replication (XDCR)<\/h2>\n\n\n\n<p><b>This option applies to the following versions of self-managed Couchbase Server:<\/b><\/p>\n\n\n\n<ul class=\"wp-block-list\">\n<li><span>Enterprise Edition version 6.6, 7.0.x, 7.1<\/span><\/li>\n\n<\/ul>\n\n\n\n<p><span>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\n\n\n<p>\u00a0<\/p>\n\n\n\n<h3 class=\"wp-block-heading\">Connect self-managed Couchbase Server cluster to Couchbase Capella cluster<\/h3>\n\n\n\n<p><strong>Enterprise Edition only<\/strong><\/p>\n\n\n\n<ul class=\"wp-block-list\">\n<li><span>In the Couchbase Capella UI main navigation click <strong>Clusters<\/strong>, then click on the target cluster for migration<\/span><\/li>\n\n\n<li><span>Click the <strong>Connect<\/strong> tab, then under <em>Wide Area Network<\/em> click <strong>Manage Allowed IP<\/strong><\/span><\/li>\n\n\n<li><span>On the Allowed IP screen, click <strong>Add Allowed IP<\/strong><\/span><\/li>\n\n\n<li><span>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\n\n<li><span>Click <strong>Add IP<\/strong><\/span><\/li>\n\n\n<li><span>Repeat for each cluster node IP address<\/span><\/li>\n\n\n<li><span>Click <strong>&lt; BACK<\/strong>\u00a0to go to the previous screen<\/span><\/li>\n\n<\/ul>\n\n\n\n<p><b>Note:<\/b><span> 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\n\n\n<ul class=\"wp-block-list\">\n<li><span>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\n\n<li><span>Under <em>Root Certificate<\/em>, click <strong>Copy<\/strong>\u00a0(this will capture the certificate to your clipboard for pasting)<\/span><\/li>\n\n\n<li><span>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\n<\/ul>\n\n\n\n<p><span>Enter the following settings:<\/span><\/p>\n\n\n\n<ul class=\"wp-block-list\">\n<li><span><strong>Cluster Name<\/strong> \u2013 enter a name for the remote cluster connection<\/span><\/li>\n\n\n<li><span><strong>IP\/Hostname<\/strong> \u2013 enter the Couchbase Capella cluster endpoint URL you copied earlier<\/span><\/li>\n\n\n<li><span><strong>Username<\/strong> <strong>for Remote Cluster<\/strong> \u2013 enter the database credentials username for your Capella target cluster<\/span><\/li>\n\n\n<li><span><strong>Password<\/strong> \u2013 enter the password for the database credentials user for your Capella target cluster<\/span><\/li>\n\n\n<li><span><strong>Enable Secure Connection<\/strong> \u2013 checked<\/span><\/li>\n\n\n<li><span>Select the <strong>Full<\/strong>\u00a0radio button<\/span><\/li>\n\n\n<li><span>Paste the Capella cluster root certificate you copied earlier<\/span><\/li>\n\n\n<li><span>Click <strong>Save<\/strong><\/span><\/li>\n\n<\/ul>\n\n\n\n<h3 class=\"wp-block-heading\">Set up Couchbase XDCR<\/h3>\n\n\n\n<p><strong>Enterprise Edition only:<\/strong><\/p>\n\n\n\n<p><span>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\n\n\n<p><span>NOTE: XDCR does not migrate indexes.<\/span><\/p>\n\n\n\n<p><span>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\n\n\n<p><span>Enter the following settings:<\/span><\/p>\n\n\n\n<ul class=\"wp-block-list\">\n<li><span><strong>Replicate From Bucket<\/strong> \u2013 select the source bucket for migration<\/span><\/li>\n\n\n<li><span><strong>Remote Bucket<\/strong> \u2013 enter the remote bucket name<\/span><\/li>\n\n\n<li><span><strong>Remote Cluster<\/strong> \u2013 select the remote cluster you created earlier<\/span><\/li>\n\n\n<li><span>Click <strong>Save replication<\/strong><\/span><\/li>\n\n<\/ul>\n\n\n\n<p><span>The replication process should begin within a few seconds.<\/span><\/p>\n\n\n\n<h3 class=\"wp-block-heading\">Verify the migration<\/h3>\n\n\n\n<p><b><i>Data migration:<\/i><\/b><\/p>\n\n\n\n<ul class=\"wp-block-list\">\n<li><span>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\n\n<li><span>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\n\n<li><span>In the target cluster, choose <strong>Documents<\/strong> in the <strong>Tools<\/strong>\u00a0dropdown list. Verify that all documents were migrated<\/span><\/li>\n\n<\/ul>\n\n\n\n<p><b><i>Index migration:<\/i><\/b><\/p>\n\n\n\n<p><span>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\n\n\n<p><b><i>Query runtime:<\/i><\/b><\/p>\n\n\n\n<p><span>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\n\n\n<p><span>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\n\n\n<h2 class=\"wp-block-heading\">Related resources<\/h2>\n\n\n\n<p><b>Preparing to migrate:<\/b><\/p>\n\n\n\n<ul class=\"wp-block-list\">\n<li><a href=\"https:\/\/cloud.couchbase.com\/sign-up?ref=blog\" target=\"_blank\" rel=\"noopener\"><span>Get started with the Couchbase Capella free tier<\/span><\/a><\/li>\n\n\n<li><a href=\"https:\/\/docs.couchbase.com\/cloud\/index.html\" target=\"_blank\" rel=\"noopener\"><span>Couchbase Capella documentation<\/span><\/a><\/li>\n\n\n<li><a href=\"https:\/\/cloud.couchbase.com\/sign-up\" target=\"_blank\" rel=\"noopener\"><span>Create a Couchbase Capella account<\/span><\/a><\/li>\n\n\n<li><a href=\"https:\/\/docs.couchbase.com\/cloud\/clusters\/sizing.html\" target=\"_blank\" rel=\"noopener\"><span>Couchbase Capella sizing guidelines<\/span><\/a><\/li>\n\n\n<li><a href=\"https:\/\/docs.couchbase.com\/cloud\/clusters\/scale-cluster.html\" target=\"_blank\" rel=\"noopener\"><span>Couchbase Capella cluster scaling<\/span><\/a><span>\u00a0<\/span><\/li>\n\n\n<li><a href=\"https:\/\/docs.couchbase.com\/cloud\/clouds\/private-network.html\" target=\"_blank\" rel=\"noopener\"><span>Configure a private network on Couchbase Capella<\/span><\/a><span>\u00a0<\/span><\/li>\n\n\n<li><a href=\"https:\/\/docs.couchbase.com\/server\/current\/introduction\/intro.html\" target=\"_blank\" rel=\"noopener\"><span>Couchbase Server documentation<\/span><\/a><\/li>\n\n\n<li><a href=\"https:\/\/docs.couchbase.com\/server\/current\/install\/sizing-general.html\" target=\"_blank\" rel=\"noopener\"><span>Couchbase Server cluster sizing guidelines<\/span><\/a><\/li>\n\n\n<li><a href=\"https:\/\/www.couchbase.com\/products\/editions\/\" target=\"_blank\" rel=\"noopener\"><span>Couchbase Enterprise vs Community Edition<\/span><\/a><\/li>\n\n\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\n<\/ul>\n\n\n\n<p><b>Deploy and configure resources on Couchbase Capella:<\/b><\/p>\n\n\n\n<ul class=\"wp-block-list\">\n<li><a href=\"https:\/\/docs.couchbase.com\/cloud\/security\/manage-database-users.html\" target=\"_blank\" rel=\"noopener\"><span>Configure a database credential on Couchbase Capella<\/span><\/a><\/li>\n\n\n<li><a href=\"https:\/\/docs.couchbase.com\/cloud\/clusters\/data-service\/manage-buckets.html\" target=\"_blank\" rel=\"noopener\"><span>Couchbase Capella buckets overview<\/span><\/a><\/li>\n\n\n<li><a href=\"https:\/\/docs.couchbase.com\/cloud\/clusters\/clusters.html\" target=\"_blank\" rel=\"noopener\"><span>Couchbase Capella cluster overview<\/span><\/a><\/li>\n\n\n<li><a href=\"https:\/\/docs.couchbase.com\/cloud\/projects\/projects.html\" target=\"_blank\" rel=\"noopener\"><span>Couchbase Capella projects overview<\/span><\/a><\/li>\n\n\n<li><a href=\"https:\/\/docs.couchbase.com\/cloud\/clusters\/create-cluster.html\" target=\"_blank\" rel=\"noopener\"><span>Create a cluster on Couchbase Capella<\/span><\/a><\/li>\n\n\n<li><a href=\"https:\/\/docs.couchbase.com\/cloud\/clusters\/data-service\/manage-buckets.html#add-bucket\" target=\"_blank\" rel=\"noopener\"><span>Create a new bucket on Couchbase Capella<\/span><\/a><\/li>\n\n<\/ul>\n\n\n\n<p>\u00a0<\/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 all use cases with built-in multi-model capabilities. Its memory-first architecture drives high speed data response [&hellip;]<\/p>\n","protected":false},"author":82066,"featured_media":2205,"comment_status":"open","ping_status":"open","sticky":false,"template":"","format":"standard","meta":{"_acf_changed":false,"inline_featured_image":false,"footnotes":""},"categories":[301,54,28],"tags":[337,283],"ppma_author":[284],"class_list":["post-2207","post","type-post","status-publish","format-standard","has-post-thumbnail","hentry","category-cloud","category-couchbase-server","category-xdcr","tag-cbbackupmgr","tag-database-migration"],"yoast_head":"<!-- This site is optimized with the Yoast SEO Premium plugin v27.6 (Yoast SEO v27.6) - https:\/\/yoast.com\/product\/yoast-seo-premium-wordpress\/ -->\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=\"og:image\" content=\"https:\/\/www.couchbase.com\/blog\/wp-content\/uploads\/sites\/5\/2026\/05\/blog-capella-migration.png\" \/>\n\t<meta property=\"og:image:width\" content=\"2400\" \/>\n\t<meta property=\"og:image:height\" content=\"1256\" \/>\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\\\/pt\\\/how-to-migrate-from-couchbase-server-to-couchbase-capella\\\/#article\",\"isPartOf\":{\"@id\":\"https:\\\/\\\/www.couchbase.com\\\/blog\\\/pt\\\/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\",\"mainEntityOfPage\":{\"@id\":\"https:\\\/\\\/www.couchbase.com\\\/blog\\\/pt\\\/how-to-migrate-from-couchbase-server-to-couchbase-capella\\\/\"},\"wordCount\":3963,\"commentCount\":0,\"publisher\":{\"@id\":\"https:\\\/\\\/www.couchbase.com\\\/blog\\\/#organization\"},\"image\":{\"@id\":\"https:\\\/\\\/www.couchbase.com\\\/blog\\\/pt\\\/how-to-migrate-from-couchbase-server-to-couchbase-capella\\\/#primaryimage\"},\"thumbnailUrl\":\"https:\\\/\\\/www.couchbase.com\\\/blog\\\/wp-content\\\/uploads\\\/sites\\\/5\\\/2026\\\/05\\\/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\\\/pt\\\/how-to-migrate-from-couchbase-server-to-couchbase-capella\\\/#respond\"]}]},{\"@type\":\"WebPage\",\"@id\":\"https:\\\/\\\/www.couchbase.com\\\/blog\\\/pt\\\/how-to-migrate-from-couchbase-server-to-couchbase-capella\\\/\",\"url\":\"https:\\\/\\\/www.couchbase.com\\\/blog\\\/pt\\\/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\\\/pt\\\/how-to-migrate-from-couchbase-server-to-couchbase-capella\\\/#primaryimage\"},\"image\":{\"@id\":\"https:\\\/\\\/www.couchbase.com\\\/blog\\\/pt\\\/how-to-migrate-from-couchbase-server-to-couchbase-capella\\\/#primaryimage\"},\"thumbnailUrl\":\"https:\\\/\\\/www.couchbase.com\\\/blog\\\/wp-content\\\/uploads\\\/sites\\\/5\\\/2026\\\/05\\\/blog-capella-migration.png\",\"datePublished\":\"2024-10-16T18:11:37+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\\\/pt\\\/how-to-migrate-from-couchbase-server-to-couchbase-capella\\\/#breadcrumb\"},\"inLanguage\":\"en-US\",\"potentialAction\":[{\"@type\":\"ReadAction\",\"target\":[\"https:\\\/\\\/www.couchbase.com\\\/blog\\\/pt\\\/how-to-migrate-from-couchbase-server-to-couchbase-capella\\\/\"]}]},{\"@type\":\"ImageObject\",\"inLanguage\":\"en-US\",\"@id\":\"https:\\\/\\\/www.couchbase.com\\\/blog\\\/pt\\\/how-to-migrate-from-couchbase-server-to-couchbase-capella\\\/#primaryimage\",\"url\":\"https:\\\/\\\/www.couchbase.com\\\/blog\\\/wp-content\\\/uploads\\\/sites\\\/5\\\/2026\\\/05\\\/blog-capella-migration.png\",\"contentUrl\":\"https:\\\/\\\/www.couchbase.com\\\/blog\\\/wp-content\\\/uploads\\\/sites\\\/5\\\/2026\\\/05\\\/blog-capella-migration.png\",\"width\":2400,\"height\":1256},{\"@type\":\"BreadcrumbList\",\"@id\":\"https:\\\/\\\/www.couchbase.com\\\/blog\\\/pt\\\/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\\\/sites\\\/5\\\/2026\\\/06\\\/logo.svg\",\"contentUrl\":\"https:\\\/\\\/www.couchbase.com\\\/blog\\\/wp-content\\\/uploads\\\/sites\\\/5\\\/2026\\\/06\\\/logo.svg\",\"width\":\"1024\",\"height\":\"1024\",\"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:\\\/\\\/secure.gravatar.com\\\/avatar\\\/4760a19fc4ed6b8b830ba98f0869ed0d8ee6729e2593881e1a68032b9c281d5d?s=96&d=mm&r=g5112ed57023bd2807ae7086c2fe68752\",\"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","og_image":[{"width":2400,"height":1256,"url":"https:\/\/www.couchbase.com\/blog\/wp-content\/uploads\/sites\/5\/2026\/05\/blog-capella-migration.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\/pt\/how-to-migrate-from-couchbase-server-to-couchbase-capella\/#article","isPartOf":{"@id":"https:\/\/www.couchbase.com\/blog\/pt\/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","mainEntityOfPage":{"@id":"https:\/\/www.couchbase.com\/blog\/pt\/how-to-migrate-from-couchbase-server-to-couchbase-capella\/"},"wordCount":3963,"commentCount":0,"publisher":{"@id":"https:\/\/www.couchbase.com\/blog\/#organization"},"image":{"@id":"https:\/\/www.couchbase.com\/blog\/pt\/how-to-migrate-from-couchbase-server-to-couchbase-capella\/#primaryimage"},"thumbnailUrl":"https:\/\/www.couchbase.com\/blog\/wp-content\/uploads\/sites\/5\/2026\/05\/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\/pt\/how-to-migrate-from-couchbase-server-to-couchbase-capella\/#respond"]}]},{"@type":"WebPage","@id":"https:\/\/www.couchbase.com\/blog\/pt\/how-to-migrate-from-couchbase-server-to-couchbase-capella\/","url":"https:\/\/www.couchbase.com\/blog\/pt\/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\/pt\/how-to-migrate-from-couchbase-server-to-couchbase-capella\/#primaryimage"},"image":{"@id":"https:\/\/www.couchbase.com\/blog\/pt\/how-to-migrate-from-couchbase-server-to-couchbase-capella\/#primaryimage"},"thumbnailUrl":"https:\/\/www.couchbase.com\/blog\/wp-content\/uploads\/sites\/5\/2026\/05\/blog-capella-migration.png","datePublished":"2024-10-16T18:11:37+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\/pt\/how-to-migrate-from-couchbase-server-to-couchbase-capella\/#breadcrumb"},"inLanguage":"en-US","potentialAction":[{"@type":"ReadAction","target":["https:\/\/www.couchbase.com\/blog\/pt\/how-to-migrate-from-couchbase-server-to-couchbase-capella\/"]}]},{"@type":"ImageObject","inLanguage":"en-US","@id":"https:\/\/www.couchbase.com\/blog\/pt\/how-to-migrate-from-couchbase-server-to-couchbase-capella\/#primaryimage","url":"https:\/\/www.couchbase.com\/blog\/wp-content\/uploads\/sites\/5\/2026\/05\/blog-capella-migration.png","contentUrl":"https:\/\/www.couchbase.com\/blog\/wp-content\/uploads\/sites\/5\/2026\/05\/blog-capella-migration.png","width":2400,"height":1256},{"@type":"BreadcrumbList","@id":"https:\/\/www.couchbase.com\/blog\/pt\/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\/sites\/5\/2026\/06\/logo.svg","contentUrl":"https:\/\/www.couchbase.com\/blog\/wp-content\/uploads\/sites\/5\/2026\/06\/logo.svg","width":"1024","height":"1024","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:\/\/secure.gravatar.com\/avatar\/4760a19fc4ed6b8b830ba98f0869ed0d8ee6729e2593881e1a68032b9c281d5d?s=96&d=mm&r=g5112ed57023bd2807ae7086c2fe68752","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\/"}]}},"acf":[],"authors":[{"term_id":284,"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\/5\/2026\/05\/image_2022-06-17_105452255-40.png","url2x":"https:\/\/www.couchbase.com\/blog\/wp-content\/uploads\/sites\/5\/2026\/05\/image_2022-06-17_105452255-40.png"},"0":null,"1":"","2":"","3":"","4":"","5":"","6":"","7":"","8":""}],"_links":{"self":[{"href":"https:\/\/www.couchbase.com\/blog\/wp-json\/wp\/v2\/posts\/2207","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=2207"}],"version-history":[{"count":0,"href":"https:\/\/www.couchbase.com\/blog\/wp-json\/wp\/v2\/posts\/2207\/revisions"}],"wp:featuredmedia":[{"embeddable":true,"href":"https:\/\/www.couchbase.com\/blog\/wp-json\/wp\/v2\/media\/2205"}],"wp:attachment":[{"href":"https:\/\/www.couchbase.com\/blog\/wp-json\/wp\/v2\/media?parent=2207"}],"wp:term":[{"taxonomy":"category","embeddable":true,"href":"https:\/\/www.couchbase.com\/blog\/wp-json\/wp\/v2\/categories?post=2207"},{"taxonomy":"post_tag","embeddable":true,"href":"https:\/\/www.couchbase.com\/blog\/wp-json\/wp\/v2\/tags?post=2207"},{"taxonomy":"author","embeddable":true,"href":"https:\/\/www.couchbase.com\/blog\/wp-json\/wp\/v2\/ppma_author?post=2207"}],"curies":[{"name":"wp","href":"https:\/\/api.w.org\/{rel}","templated":true}]}}