A newer version of this documentation is available.

View Latest


      The Cluster panel can be used to establish settings for the cluster.

      Configuring Cluster Settings

      Only Full Administrators and Cluster Administrators can configure cluster settings.

      Use the Settings > Cluster tab to configure the cluster name, memory quotas, and index settings. You can define the settings using Couchbase Web Console, the CLI, or the REST API.

      cluster settings

      To configure cluster settings using Couchbase Web Console:

      1. Select the Couchbase Web Console > Settings menu. By default, the Cluster page is displayed.

      2. Enter appropriate information into the fields listed below, and click Save:

      Cluster Name

      Option Description

      Cluster Name

      The name that was given during the initial setup. You can change it at any time.

      Couchbase Memory Quotas

      The per-node memory that is available to Couchbase services limited to the smallest node in the cluster. These values can be adjusted in the UI, with the CLI or with the REST API.

      Option Description

      Data Service

      The per node memory allocation for the key-value cache used by the data service. At a minimum, it cannot be made smaller than the sum per node bucket quota of all buckets combined.

      Index Service

      This setting controls the buffer cache size of the index storage layer. The specified memory is pre-allocated as soon as the indexer starts up, and is shared with all indexes created on the node. The total memory usage of the indexer process will be the buffer cache plus the size of various internal data structures and queues.

      Search Service

      This setting controls the RAM quota for Full Text search. It shows the amount of the main memory allocation for Full Text service per node.

      Analytics Service

      This setting controls the RAM quota for Analytics. It shows the amount of the main memory allocation for the Analytics service per node.

      Eventing Service

      This setting controls the RAM quota for Events. It shows the amount of the main memory allocation for the Events service per node.

      Advanced Query Settings

      Specify either Unrestricted or Restricted, to determine which URLs are permitted to be accessed by the curl function. If Unrestricted (the default) is specified, all URLs can be accessed. If Restricted is specified, the UI expands, to display configurable fields into which the URLs allowed and disallowed can be entered.

      Advanced Index Settings for Standard and Memory-Optimized Indexes

      Define the Index Storage Mode as Standard Global Secondary or Memory-Optimized, then click the Advanced Index Settings pull-down menu.

      Option Description

      Indexer Threads

      The number of dedicated threads used by the Index Service. The number can be increased on multi-core machines to increase the amount of CPU available to the Indexer. The default is set to 0.

      Max Rollback Points

      The maximum number of the committed rollback points. The default is set to 5.

      Indexer Log Level

      Adjust the logging level from least to most verbose, the options are: Silent, Fatal, Error, Warn, Info, Verbose, Timing, Debug, and Trace. The default is set to Info. It is advised to leave this setting as the default unless Couchbase Support directs you to change it.

      Query Temp Disk Path

      The path to which temporary files are written, based on query activities. Specify a maximum size in megabytes.