How to Install CouchDB on Ubuntu 22.04

Apache CouchDB is an open-source NoSQL database released 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’ll explain how to install CouchDB on Ubuntu 22.04.

Step 1 – Update System

First of all, you need to check for system update and if any package update available you have to update by issuing below given command:

sudo apt update && upgrade

Step 2 – Install Dependency

Use following command to install dependency:

sudo apt install -y curl apt-transport-https gnupg

Step 3 – Enabling CouchDB repository

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

curl https://couchdb.apache.org/repo/keys.asc | gpg –dearmor | sudo tee /usr/share/keyrings/couchdb-archive-keyring.gpg >/dev/null 2>&1

echo "deb [signed-by=/usr/share/keyrings/couchdb-archive-keyring.gpg] https://apache.jfrog.io/artifactory/couchdb-deb/ ${VERSION_CODENAME} main" | sudo tee /etc/apt/sources.list.d/couchdb.list >/dev/null

Step 4 – Install CouchDB

After enabling the repository, update the packages list and install CouchDB:

sudo apt update

sudo apt install -y 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.

select mode install couchdb on ubuntu 22.04

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.

select interface install couchdb on ubuntu 22.04

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.

confirm password install couchdb on ubuntu 22.04

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

At this point, the installation is completed.

Step 5 – 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":"ff0feea20",
  "uuid":"4589130c33b0dae4c166330463542ad4",
  "features":[
    "access-ready",
    "partitioned",
    "pluggable-storage-engines",
    "reshard",
    "scheduler"
  ],
  "vendor":{
    "name":"The Apache Software Foundation"
  }
}

Enter url http://127.0.0.1:5984/_utils/ to your web browser to access the CouchDB web-based interface. It will show as following:

Conclusion

That’s it. We have successfully learned how to install CouchDB on Ubuntu 22.04 system. To learn more, take a look at Apache CouchDB Documentation.

Feel free to leave comment if you have any question or suggestion.

Tags: couchdb, database, ubuntu