How to Install CouchDB on Debian 11

Apache CouchDB is an open-source NoSQL database developed by the Apache Software Foundation. It uses JSON to represent data stored in a database. The CouchDB RESTful HTTP/JSON API allows you to read, edit, delete and create database documents. In this guide, we will explain how to install CouchDB on Debian 11 system.

How to Install CouchDB on Debian 11#

Perform the following steps to install CouchDB on your Debian system:

Step 1 – Update system packages#

First of all you should update the system packages using below given command:

sudo apt update && sudo apt upgrade

Step 2 – Add CouchDB repository#

Next, we will add CouchDB repository and import GPG key as root or user with sudo privileges:

echo "deb https://apache.bintray.com/couchdb-deb buster main" | sudo tee -a /etc/apt/sources.list

curl -L https://couchdb.apache.org/repo/bintray-pubkey.asc | sudo apt-key add -

Step 3 – Install CouchDB#

After that, update the packages list and install CouchDB by issuing below given commands:

sudo apt update

sudo apt install couchdb

It will prompt you to choose option whether you want to install CouchDB in a standalone or clustered mode. We’ll install the CouchDB in a single-server standalone mode.

In next step, you can set IP address on which CouchDB will bind. Leave it as default value 127.0.0.1. If you are configuring a cluster, enter the interface IP address or type 0.0.0.0, which tells CouchDB to binds to all network interfaces.

After that, set the password for admin. If you leave this field blank it will not create admin user. It is highly recommended to set the password, and take CouchDB out of the insecure “admin party” mode.

Again enter the password to confirm and the installation will continue.

Step 4 – Verify Installation#

The CouchDB server will run at localhost:5984. Run the following curl command to display information about the CouchDB database in JSON format:

curl http://127.0.0.1:5984/

If it will print output as following means that the installation was successful and the service is running.

{
   "couchdb":"Welcome",
   "version":"3.2.2",
   "git_sha":"03a77db6c",
   "uuid":"advb3f42ce6a07245d2955c1d6832266",
   "features":[
      "access-ready",
      "partitioned",
      "pluggable-storage-engines",
      "reshard",
      "scheduler"
   ],
   "vendor":{
      "name":"The Apache Software Foundation"
   }
}

You can access the CouchDB web-based interface by entering http://127.0.0.1:5984/_utils/ to your web browser. It will show as following:

Conclusion#

You have successfully learned how to install CouchDB on Debian 11 system. To learn more, take a look at Apache CouchDB Documentation.

If you have any question or feedback, please leave comment below.