Couchbase Server Quota

The Couchbase Server quota is the amount of RAM available on each server allocated to Couchbase for all buckets. You may want to change this value if you have increased the physical RAM in your server, or added new nodes with a higher RAM configuration in a cloud deployment.

The Couchbase Server quota is initially set when you install the first node in your cluster. All nodes in the cluster use the same server quota configuration. The configuration value is set by configuring the RAM allocation for all nodes within the cluster.

To change the Couchbase Server Quota, use the couchbase-cli command, using the cluster-init command and the --cluster-init-ramsize option. For example, to set the server RAM quota to 8GB:

shell> couchbase-cli cluster-init -c 127.0.0.1 \
    -u Administrator -p Password \
    --cluster-init-ramsize=8192

Setting the value on one node sets the RAM quota for all the configured nodes within the cluster.

Bucket Quota

The bucket quota is the RAM allocated to an individual bucket from within the RAM allocated to the nodes in the cluster. The configuration is set on a per node basis; i.e. configuring a bucket with 100MB per node on an eight node cluster provides a total bucket size of 800MB.

The easiest way to configure the Bucket Quota is through the Couchbase Web Console. For more details, see Section 6.3.1.2, “Editing Couchbase Buckets”.

The value can also be modified from the command-line using the couchbase-cli command:

shell> /opt/couchbase/bin/couchbase-cli bucket-edit -c 127.0.0.1 \
    -u Administrator -p Password \
    --bucket=beer-sample --bucket-ramsize=200