Couchbase Server Startup and Shutdown

Couchbase Server Startup and Shutdown

Use startup and shutdown scripts to manually start or shut down Couchbase Server.

Start and Stop on Linux

On Linux, Couchbase Server is installed as a standalone application with support for running as a background (daemon) process during start-up through the use of a standard control script, which is located in /etc/init.d/couchbase-server.

The startup script is automatically installed during installation from one of the Linux packaged releases (Debian/Ubuntu or Red Hat/CentOS). By default, Couchbase Server is configured to be started automatically at run levels 2, 3, 4, and 5, and explicitly shut down at run levels 0, 1 and 6.

To manually start Couchbase Server using the startup/shutdown script:
  • For RHEL 6:
     # sudo service couchbase-server start
  • For RHEL 7:
    # sudo systemctl start couchbase-server
To manually stop Couchbase Server using the startup/shutdown script:
  • For RHEL 6, as a root user:
    # sudo service couchbase-server stop
  • For RHEL 7:
    # sudo systemctl stop couchbase-server

On Windows

On Windows, Couchbase Server is installed as a Windows service. You can use the Services tab within the Windows Task Manager to start and stop Couchbase Server.

You will need a power user or administrator privileges, or have separately granted rights to manage services to start and stop Couchbase Server. By default, the service automatically starts when the machine boots.

Couchbase Server can be started and stopped via Windows Task Manager, Windows system net command, and Couchbase-supplied .bat scripts.

Start manually with the Task Manager

To manually start the service from the Windows interface:

  1. Open the Windows Task Manager and select the Services tab to open the Services management console.
  2. Alternatively, select the Start, select Run and then type Services.msc to open the Services management console.
  3. Locate the Couchbase Server service and right-click.
  4. Select Start or Stop as appropriate.
Note: You can also alter the configuration so that the service is not automatically started during boot.

Start and Stop with the net command

To start and stop Couchbase Server using net:

net start CouchbaseServer
net stop CouchbaseServer

Start and stop with the .bat scripts

The Couchbase-supplied start and stop scripts are provided in the standard installation in the bin directory.

To start and stop Couchbase Server, use the scripts located in:

C:\Program Files\Couchbase\Server\bin\service_start.bat

C:\Program Files\Couchbase\Server\bin\service_stop.bat

On Mac OS

On Mac OS X, Couchbase Server is supplied as a standard application that runs in background and can be controlled with an icon installed in the menu bar.

The individual menu options perform the following actions:

About Couchbase Server
Opens a standard dialog containing the licensing and version information for the installed Couchbase Server.
Open Couchbase Web Console
Opens the Web Administration Console in your configured default browser.
Visit Support Forum
Opens the Couchbase Server support forum within your default browser at the Couchbase website where you can post questions to other users and Couchbase developers.
Check for Updates
Checks for updated versions of Couchbase Server, the currently installed version against the latest version available, and offers to download and install the new version.

If a new version is available, you will be presented with a dialog containing information about the new release. You can choose to skip the update, receive notification at a later date, or automatically update the software to the new version.

If you choose the automatic update, the latest available version of Couchbase Server will be downloaded to your machine, and you will be prompted to allow the installation to take place. Installation will shut down your existing Couchbase Server process, install the update, and then restart the service after the installation was completed. You will be asked whether you want to automatically update Couchbase Server in the future.

Using the update service also sends anonymous usage data to Couchbase on the current version and cluster used in your organization. This information is used to improve service offerings.

You can also enable automated updates by selecting the Automatically download and install updates in the future check box.

Launch Couchbase Web Console at Start
If this menu item is checked, the Couchbase Web Console is opened whenever Couchbase Server starts.
Automatically Start at Login
If this menu item is checked, Couchbase Server is automatically started when the Mac OS X machine starts.
Quit Couchbase Server
Electing this menu option will shut down your running Couchbase Server and close the menu bar interface. To restart, you must open the Couchbase Server application from the installation folder.