You are viewing the documentation for a prerelease version.

View Latest

Uninstall Couchbase Server

The Couchbase Server application and its associated data can be removed from supported systems.

Uninstalling Couchbase Server from a system involves removing the Couchbase Server application along with any directories containing Couchbase configuration files, data, and logs.

Before You Uninstall

If the system is a part of an active Couchbase cluster, you’ll need to remove it and rebalance the cluster to take the node out of the configuration. You’ll also need to update Couchbase clients to point to an available node within the active cluster.

The instructions on this page will completely remove Couchbase Server, and all configuration and database files. Ensure that your configuration and data are backed up before proceeding, as this process cannot be undone.

Linux

  1. Stop the Couchbase Server process if it’s running.

    sudo systemctl stop couchbase-server

    Refer to Start and Stop Couchbase Server for more information.

  2. Remove the application and packages.

    • RHEL, CentOS, SUSE, Oracle, and Amazon Linux

    • Ubuntu and Debian

    sudo rpm -e couchbase-server
    sudo dpkg -r couchbase-server
  3. Remove the data and log directories.

    sudo rm -rf /opt/couchbase

    If, during initial setup of the node, you specified non-default locations for Couchbase data, indexes, etc., then you’ll need to locate those files as well and delete them in order to complete the uninstall process.

Windows

To uninstall Couchbase Server on Windows, you must have Administrator or Power User privileges.

  1. Remove the application.

    Go to Start  Settings and click on Apps. From the list of applications, click on Couchbase Server, and then click Uninstall.

    A dialogue window may appear asking for your permission to run the uninstall utility. If this is the case, click Yes to continue.

  2. Remove the data and log directories.

    Open File Explorer and go to C:\Program Files\. Drag the Couchbase folder to the Recycle Bin.

    If, during initial setup of the node, you specified non-default locations for Couchbase data, indexes, etc., then you’ll need to locate those files as well and delete them in order to complete the uninstall process.

macOS

  • UI

  • Terminal

  1. Quit Couchbase Server if it’s running.

    Click Couchbase Server menu bar icon and select menu:[Quit Couchbase Server]. The menu bar icon will disappear when Couchbase Server shuts down.

    Refer to Start and Stop Couchbase Server for more information.

  2. Remove the application.

    Go to the Applications folder and drag Couchbase Server.app to the Trash.

  3. Remove the data and log directories.

    Open Finder and go to ~/Library/Application Support/, and drag both the Couchbase and Membase folders (if present) to the Trash.

    Next, go to ~/Library/Python/, and drag the couchbase-py folder to the Trash.

    If you don’t see the Library folder in your home folder, you can choose to follow the Terminal instructions instead, or you can toggle-on the Library folder. To toggle-on the Library folder, first click on Finder, then click on menu:[View,Show View Options] in the menu bar, then check the checkbox next to Show Library Folder.
  1. Quit Couchbase Server if it’s running.

    osascript -e 'quit app "Couchbase Server"'

    You may receive the following error: 0:27: execution error: Couchbase Server got an error: User canceled. (-128). You can ignore this error. Refer to Start and Stop Couchbase Server for more information.

  2. Remove the application.

    rm -rf /Applications/Couchbase\ Server.app
  3. Remove the data and log directories.

    rm -rf ~/Library/Application\ Support/Couchbase && rm -rf ~/Library/Application\ Support/membase && rm -rf ~/Library/Python/couchbase-py

If, during initial setup of the node, you specified non-default locations for Couchbase data, indexes, etc., then you’ll need to locate those files as well and delete them in order to complete the uninstall process.