Please use the form below to provide your feedback. Because your feedback is valuable to us, the information you submit in this form is recorded in our issue tracking system (JIRA), which is publicly available. You can track the status of your feedback using the ticket number displayed in the dialog once you submit the form.

A newer version of this documentation is available.

View Latest

Performing Compaction Manually

  • reference
March 16, 2025
+ 12
Couchbase Server allows a bucket’s data to be compacted manually.

Description

Couchbase Server allows a specified bucket’s data to be compacted by the administrator, manually. Full Admin and Cluster Admin permissions are required.

HTTP methods and URIs

The following methods and URIs allow explicit initiation and cancellation of data-compaction for a specified bucket:

POST /pools/default/buckets/[bucket-name]/controller/compactBucket

POST /pools/default/buckets/[bucket-name]/controller/cancelBucketCompaction

Curl Syntax

curl -i -X POST -u [admin]:[password]
  http://[localhost]:8091/pools/default/buckets/[bucket-name]/controller/compactBucket

curl -i -X POST -u [admin]:[password]
  http://[localhost]:8091/pools/default/buckets/[bucket-name]/controller/cancelBucketCompaction

Responses

If the call is successful, 200 OK is given, and an object containing group-related information is returned. An incorrectly specified bucket-name or URI gives 404 Object Not Found. Failure to authenticate gives 401 Unauthorized.

Example

The following example performs compaction on the bucket travel-sample:

curl -i -v -X POST -u Administrator:password \
http://10.143.193.101:8091/pools/default/buckets/travel-sample/controller/compactBucket

Once initiated, the compaction-process can be terminated, with a call such as the following:

curl -i -v -X POST -u Administrator:password \
http://10.143.193.101:8091/pools/default/buckets/travel-sample/controller/cancelBucketCompaction

See Also

REST APIs for establishing and retrieving auto-compaction settings are provided in Auto-Compaction: Global and Auto-Compaction: Per Bucket.

See Auto-Compaction, for information on managing auto-compaction with Couchbase Web Console.