Cloud Global

Cloud Global

Our mission is to provide clients with an online user community of industry peers and IBM experts, to exchange tips and tricks, best practices, and product knowledge. We hope the information you find here helps you maximize the value of your IBM Cloud solutions.

 View Only
Expand all | Collapse all

What local account do you use to set up replication from a remote couchdb

  • 1.  What local account do you use to set up replication from a remote couchdb

    Posted Fri December 05, 2025 05:29 PM

    I am getting started with IBM Cloudant, so account recently created. I would like to replicate a remote couchdb database to Cloudant. What account should I use in Cloudant for the replication? Where or how do I create this account?



    ------------------------------
    Oscar Bautista
    ------------------------------


  • 2.  RE: What local account do you use to set up replication from a remote couchdb

    Posted Wed February 11, 2026 09:34 PM
    Edited by Venkata Thej deep Jakkaraju Thu February 12, 2026 03:26 PM

    @Oscar Bautista

    You don't need to create a special "local" CouchDB account inside Cloudant for replication.

    In IBM Cloudant, authentication is handled through service credentials, not traditional CouchDB admin users.

    Here's what you should do:

    First, go to your Cloudant instance in IBM Cloud → Service Credentials → create a New Credential.

    This will generate a username, password, and url. That's the account you'll use for replication.

    Then create a replication document like this:

    {
      "source": "http://remote_user:remote_pass@remote-host:5984/dbname",
      "target": "https://cloudant_user:cloudant_pass@your-account.cloudantnosqldb.appdomain.cloud/dbname",
      "create_target": true
    }

    Post it to:

    POST https://your-account.cloudantnosqldb.appdomain.cloud/_replicator

    That's it.

    Best practice: create dedicated service credentials with access only to the required database (avoid using admin-level credentials). Cloudant uses IAM under the hood, so no separate database-level user creation is needed.



    ------------------------------
    Venkata Thej deep Jakkaraju
    ------------------------------