A newer version of this documentation is available.

View Latest

Choose Your Next Steps

    Now, to complete the Getting Started sequence: consider your options as to what to do next, in order to continue improving your knowledge. The Couchbase documentation-set provides detailed information on all aspects of the system; and this section lists some of the important areas you can visit.

    Where to Learn More

    By navigating to the sections listed below, you can increase your knowledge of the areas you’ve already looked at — installation, configuration, and N1QL-querying — and also learn about new and (in some cases) quite advanced topics; such as multi-node clustering, fail-over, replication, and statistical analysis.

    Installation and Configuration

    Couchbase Server is supported on numerous popular operating systems. A complete list can be found in the section Supported Platforms. You may now wish to install Couchbase Server directly on one or more additional platforms: so, first, check to ensure that the platforms are supported.

    Then, take a look at the information provided in Installing On-Premises. This gives you links to installation-procedures for each of the individual platforms.

    Couchbase Server can be run in a variety of configurations. You can perform configuration by means of the Couchbase Web Console, via the Couchbase Command Line Interface (CLI), or with the Couchbase REST API. See the section Initialize the Cluster, for details.

    Periodically, you will also need to stop and start individual server-nodes. Information on doing this is provided in the section Couchbase Server Startup and Shutdown.


    Couchbase Server-resources are protected by mean of Role-Based Access Control (RBAC). This means that different roles are assigned to different users, each role being associated with a subset of privileges on one or more resources. This makes it possible, for example, for one user to be granted read-access on a particular bucket, while another user is granted both read and write access, on the same bucket. For a detailed explanation, see Authorization.

    Querying with N1QL

    As you’ve already seen, you can query Couchbase Server manually, using the N1QL query language and the Query Workbench provided by the Couchbase Web Console. A full introduction to N1QL can be found in the section Querying with N1QL, including information on using cbq, which allows N1QL queries to be entered at the command line.

    Additionally, N1QL queries can be specified by means of the Couchbase REST API. For information on doing so, see the section N1QL REST API

    Using the Couchbase SDK

    The Couchbase SDK exists in different versions: for node.js, Java, .NET, Go, C, PHP, and Python.

    Under the DEVELOPERS tab in the vertical navigation-bar to the left, you’ll find detailed information on all aspects of the Couchbase SDK, and how to use it. First, take a look at the section Start Using the SDK. At the top of that page is a pull-down menu, which allows you to select a language. The page for the language you select provides information on installing supportive modules and libraries; as well as code-examples, to get you started with development.

    Concepts and Architecture

    Your hands-on progress with Couchbase Server will be greatly helped by a good conceptual knowledge. This is provided under the CONCEPTS & ARCHITECTURE tab, visible in the vertical navigation-bar, to the left. Start by looking at the Overview; then, go from there.


    If you are an administrator, your priority will be to learn about system-setup and cluster-management. So, access the documentation under the ADMINISTRATORS tab, visible in the navigation-bar; which includes extensive information on clusters, data-buckets, indexing, replication, security, and more.


    In some cases, you may wish to integrate Couchbase Server with another, different data-repository. For example, you might wish to continue using your current Elasticsearch database for the performance of free text searches; and extend these searches to Couchbase Server-data, so that Couchbase-documents can be retrieved. For this to be possible, data must be shared between the repositories, and your querying coordinated between them.

    Under the INTEGRATIONS tab, you can find information about Elasticsearch and all other repositories with which you can integrate Couchbase Server, thereby enriching your existing search-and-retrieval mechanisms.

    Additional Information

    You can find extensive reference information on APIs, analytics, and tools under the REFERENCES tab, in the navigation-bar. RELEASE NOTES can also be accessed there.