Discover How to Easily Install CouchDB on CentOS 7

Introduction

Before we begin talking about how to install CouchDB on CentOS 7, let's briefly understand – What is CouchDB?

CouchDB is a popular NoSQL database that stores and manages data using a document-based approach. It offers a flexible data model, allowing for easy adaptation to changing requirements. With built-in replication and synchronization support, CouchDB ensures data availability and consistency across devices and locations.

Its scalable architecture enables efficient handling of large datasets, while offline capabilities enable seamless data access and synchronization even without an internet connection. With fault-tolerant design and high availability features, CouchDB ensures continuous data accessibility, reducing downtime and data loss risks. Overall, CouchDB is a powerful and versatile database solution for modern applications.

This tutorial explains how to install the most recent version of CouchDB on Ubuntu CentOS 7. Installing CouchDB on Ubuntu is straightforward.

Advantages of CouchDB

1. Flexible Data Model: CouchDB's document-based approach allows for dynamic and schema-less data, accommodating changing requirements.
2. Replication and Sync: Built-in support for replication and synchronization ensures data availability and consistency across multiple devices and locations.
3. Scalability: CouchDB's distributed architecture enables horizontal scaling, allowing for high-performance handling of large amounts of data.
4. Offline Support: CouchDB's built-in offline capabilities enable seamless data access and synchronization even when disconnected from the network.
5. High Availability: CouchDB's fault-tolerant design and support for multi-node clusters ensure continuous availability of data, minimizing downtime and data loss.

Prerequisites to Install CouchDB on CentOS 7

You must be logged in as a user with sudo privileges in order to install new packages on your CentOS system.

Enabling CouchDB Repository

The EPEL repository is necessary for the CouchDB repository to function. If your system does not already have the EPEL repository enabled, use the following command:

sudo dnf install https://dl.fedoraproject.org/pub/epel/epel-release-latest-7.noarch.rpm

After that, open your preferred editor and create the CouchDB repository file as follows:

sudo nano /etc/yum.repos.d/bintray-apache-couchdb-rpm.repo

Type the following text into the document:

[bintray--apache-couchdb-rpm]
name=bintray--apache-couchdb-rpm
baseurl=http://apache.bintray.com/couchdb-rpm/el$releasever/$basearch/
gpgcheck=0
repo_gpgcheck=0
enabled=1

Close the editor after saving the document.

Installing CouchDB on CentOS

Using the following command, you can now install the CouchDB packages when the repository has been enabled:

For installing CouchDB:
1. Add Repository:

sudo yum-config-manager --disable bintray--apache-couchdb-rpm
sudo yum install -y yum-utils
sudo yum-config-manager --add-repo https://couchdb.apache.org/repo/couchdb.repo

2. Install CouchDB:

sudo yum install -y couchdb

After installation is finished, activate and launch the CouchDB service:

By default, CouchDB listens solely on localhost, and no admin account is made.

The /opt/couchdb directory contains the configuration files and data for Apache CouchDB. Open the local.ini file and add a line to the [admins] section in the format username = password to create an admin account.

sudo nano /opt/couchdb/etc/local.ini

[admins]
admin = mysecretpassword

You can also change the bind address if you want to access it on public IP:

[chttpd]
;port = 5984
bind_address = 0.0.0.0

Restart the CouchDB service to convert the password to a hash:

sudo systemctl restart couchdb

Multiple admin accounts can be added using the same format. After adding a new account, the CouchDB service needs to be restarted.

Create the following system databases using curl: _users, _replicator, and _global_changes.

curl -u ADMINUSER:PASS -X PUT http://127.0.0.1:5984/_users
curl -u ADMINUSER:PASS -X PUT http://127.0.0.1:5984/_replicator
curl -u ADMINUSER:PASS -X PUT http://127.0.0.1:5984/_global_changes

Change ADMINUSER and PASS with yours.

The following output should be returned for each command:

Output

{"ok":true}

Verifying CouchDB Installation

Use the curl command below to print the data from the CouchDB database in JSON format to check if the installation was successful:

curl http://127.0.0.1:5984/

The output below has been formatted for clarity.

Output

{  
   "couchdb":"Welcome",
   "version":"2.3.1",
   "git_sha":"c298091a4",
   "uuid":"17a6b911e0d5bfe36778b387510dbd93",
   "features":[  
      "pluggable-storage-engines",
      "scheduler"
   ],
   "vendor":{  
      "name":"The Apache Software Foundation"
   }
}

You can access the CouchDB web-based interface, Fauxton, if you prefer a GUI, at:

http://127.0.0.1:5984/_utils/

FAQs Install CouchDB on CentOS 7

Conclusion

You have successfully learned how to install CouchDB on CentOS 7. Visit the Apache CouchDB Documentation to learn more about this topic.

If you have any queries, post them down below, and we'll be glad to answer them.