The Membase Server Superdupervisor.
JavaScript Erlang HTML CSS Python Ruby Other
Latest commit 09de2c2 Jun 20, 2017 @vzasade vzasade committed with ajityagaty MB-24907 Revert "MB-24881 temporary disable user caches on ns_coushdb…
… node"

This reverts commit a1be437.

Change-Id: I63b6284978e5b50c3b0b177e691a142753be46b5
Tested-by: Artem Stemkovski <>
Reviewed-by: Ajit Yagaty <>
Failed to load latest commit information.
cmake_modules add couch_index_merger/ebin to test ebin path, so couch_skew can May 23, 2017
deps MB-24907 Revert "MB-24881 temporary disable user caches on ns_coushdb… Jun 24, 2017
doc MB-19339: Add support for privilege_debug for memcached Mar 15, 2017
etc MB-19769 REST API for security settings Apr 13, 2017
include MB-22681 store bucket uuid's in bucket related roles May 2, 2017
priv MB-24166: redirect hash from old prefix #/ to new #!/ Jun 23, 2017
scripts MB-23364 cbcollect users.dets file May 11, 2017
src MB-24907 Revert "MB-24881 temporary disable user caches on ns_coushdb… Jun 24, 2017
test [meck] Convert ns_config mock_gen_server tests to use meck Jun 5, 2017
.gitignore MB-21254: erl: minify classic-ui Jan 24, 2017
CHANGES MB-8663 Mention where to find replication id. Aug 26, 2013
CMakeLists.txt [meck] add meck to the CMake build files Jun 5, 2017
GNUmakefile [test] Have make test run triq tests too. Jan 10, 2017
LICENSE bug 1626 - apache license headers on files Jun 29, 2010
README.markdown MB-14932: update README.txt Apr 13, 2016
cbbrowse_logs MB-8101: allow overriding of logs reports dir Apr 16, 2013
cbcollect_info MB-22018: Add cbstats tasks to cbcollect_info Jun 8, 2017
cluster_connect cluster_connect: Add support for 'ephemeral' bucketType Feb 9, 2017
cluster_run MB-18284: Tell indexer to open TLS managment connection Apr 13, 2017
configure MB-10807 Fix make test and make dialyzer. Apr 9, 2014 MB-23149: change max open file descriptors warn limit to 70k Jun 15, 2017 re-factor xdc_rdoc_manager and capi_ddoc_manager Feb 14, 2017


The Couchbase Server

This application represents the top of the hierarchy of all memcached smart services. It is an application in the Erlang OTP sense.


Build dependencies include:

  • erlang R16B03


You should use top level make file and repo manifest as explained here:

Runtime dependencies

Before you start the server, you may need to do the following

  • Make sure the needed ports are not being used (these include 8091, 11211, 11212, etc).


After building everything via top level makefile you'll have couchbase-server script in your $REPO/install/bin (or other prefix if you specified so). You can run this script for normal single node startup.

During development it's convenient to have several 'nodes' on your machine. There's ./cluster_run script in root directory for achieving that. Feel free to ask --help. You normally need something like -n2 where 2 is number of nodes you want.

It'll start REST API on ports 9000...9000+n. memcached on ports 12000+2i and 11999-i and moxi ports on 12001+2i ports. CAPI (which was originally expected to be couch-compatible http API implementation) is 9500...9500+n

Note that blank nodes are not configured and need to be setup. I suggest trying web UI first to get the feeling of what's possible. Just visit REST API port(s) via browser. For development mode clusters it's port 9000 and higher. For production mode it's port 8091.

Other alternative is setting up and clustering nodes via REST API. couchbase-cli allows that. And you can easily write your own script(s).

There's ./cluster_connect script that eases cluster configuration for development clusters. Again, ask --help.

Sometimes during debugging/development you want smaller number of vbuckets. You can change vbuckets number by setting COUCHBASE_NUM_VBUCKETS environment variable to desired number of vbuckets before creating new couchbase bucket.

Other tools

Couchbase ships with a bunch of nice tools. Feel free to check $REPO/install/bin (or $PREFIX/bin). One of notable tools is mbstats. It allows you to query buckets for all kinds of internal stats.

Another notable tool is couchbase-cli.

Copyright (c) 2016, Couchbase, Inc.