A newer version of this documentation is available.

View Latest


Modifies an existing bucket.


The basic syntax is:

couchbase-cli bucket-edit -c [host]:8091 -u [admin] -p [password]
    --bucket-eviction-policy=[valueOnly | fullEviction]
    --enable-flush=[0 | 1]


The command bucket-edit edits an existing bucket. It has the subset of options available for the other bucket-* commands.


The following are the command options:

Table 1. bucket-edit options
Option Description


Named bucket to act on.


Define the eviction policy: full eviction or value-only eviction.


Bucket password.


Bucket priority compared to other buckets.


Bucket RAM quota in MB.

This option does not apply to memcached-style buckets since you cannot change the RAM quota on a memcached bucket.


Replication count.


Bucket type, either memcached or Couchbase.


Enables and disables flush (yes=1, no=0).


To edit a bucket for RAM size:

couchbase-cli bucket-edit -c -u Administrator -p password \
--bucket=test_bucket --bucket-ramsize=200

To modify a bucket to high priority:

couchbase-cli bucket-edit -c -u Administrator -p password \
--bucket=test_bucket --bucket-priority=high

To modify a dedicated port bucket and set the eviction policy to fullEviction:

couchbase-cli bucket-edit -c -u Administrator -p password \
--bucket=test_bucket --bucket-ramsize=400 \
--bucket-eviction-policy=fullEviction --enable-flush=1