How to Install CouchDB on Ubuntu 20.04

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 replication allows you to synchronize two or more CouchDB databases. CouchDB RESTful HTTP/JSON API allows you to read, edit, delete and create database documents. In this tutorial, we will explain how to install CouchDB on Ubuntu 20.04 system.

Step 1 – Enabling CouchDB repository#

First of all we will enable the CouchDB repository and import GPG key as root or user with sudo privileges:

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

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

Step 2 – Installing CouchDB#

Once the repository is enabled, update the packages list and install CouchDB:

sudo apt update

sudo apt install couchdb

Installer 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.

Next, 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 3 – 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.1.0",
  "git_sha":"ff0feea20",
  "uuid":"4589130c33b0dae4c166330463542ad4",
  "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 successfully learned how to install CouchDB on Ubuntu 20.04 system. To learn more, take a look at Apache CouchDB Documentation.

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