No description or website provided.
Ruby Python CMake Shell
Latest commit 62e98af Aug 13, 2016 @mikewied mikewied committed with mikewied MB-20511: Fix create_bucket API call in cbdocloader
We updated the create_bucket call in the cluster_manager and forgot
to update cbdocloader. The new create_bucket call also includes
a synchronous create option so we no longer need to code that
waits for bucket creation in cbdocloader.

Change-Id: I156aaccab16f124a21071d4233ce81cc4ac226cb
Reviewed-by: Eben Haber <>
Tested-by: Michael Wiederhold <>


We use this tool to upload a bunch of json documents into Couchbase Server.


After you clone the project from, run the following command:


To build the package, run

make bdist

Run command



The documents parameter can be either a directory name which contains all the json documents or a .zip file which archives the document directory.

Generally speaking, the document directory should have the following layout:

/design_docs    which contains all the design docs for views.
/docs           which contains all the raw json data files. It can have other sub directories too.

All json files should be well formatted. And no spaces allowed in file names. Design docs will be uploaded after all other data files.


-n HOST[:PORT], --node=HOST[:PORT] Default port is 8091

-u USERNAME, --user=USERNAME REST username of the cluster. It can be specified in environment variable REST_USERNAME.

-p PASSWORD, --password=PASSWORD REST password of the cluster. It can be specified in environment variable REST_PASSWORD.

-b BUCKETNAME, --bucket=BUCKETNAME Specific bucket name. Default is default bucket. Bucket will be created if it doesn't exist.

-s QUOTA, RAM quota for the bucket. Unit is MB. Default is 100MB.

-h --help Show this help message and exit


# Upload documents archived in zip file ../samples/ All data will be inserted in bucket mybucket
./cbdocloader  -n localhost:8091 -u Administrator -p password -b mybucket ../samples/


These are kinds of error cases to consider ...

  • JSON files are not well formatted
  • Wrong REST username and password
  • Bucket cannot be created due to too large ram quota specified.


Beer sample

To quote from the original Open Beer Database:

This Open Beer Database is made available under the Open Database License: Any rights in individual
contents of the database are licensed under the Database Contents License:

The data was converted to JSON with the scripts from Sergey Avseyev.

Gamesim sample

The gamesim sample is licensed under the Apache License 2.0.

Travel sample

Landmarks converted to JSON from CSV dump of english version of wikivoyage. Licensed under Creative Commons Attribution Share-Alike.