How To Install Apache CouchDB on CentOS 8

In this tutorial, we will show you how to install Apache CouchDB on CentOS 8. For those of you who didn’t know, Apache CouchDB is open-source database software that focuses on ease of use and having a scalable architecture. Apache CouchDB lets you access your data where you need it.

This article assumes you have at least basic knowledge of Linux, know how to use the shell, and most importantly, you host your site on your own VPS. The installation is quite simple and assumes you are running in the root account, if not you may need to add ‘sudo‘ to the commands to get root privileges. I will show you the step-by-step installation of Apache CouchDB on a CentOS 8 server.

Prerequisites

• A server running one of the following operating systems: CentOS 8.
• It’s recommended that you use a fresh OS install to prevent any potential issues.
• A non-root sudo user or access to the root user. We recommend acting as a non-root sudo user, however, as you can harm your system if you’re not careful when acting as the root.

Install Apache CouchDB on CentOS 8

Step 1. First, let’s start by ensuring your system is up-to-date.

sudo dnf install epel-release
sudo dnf update

Step 2. Installing Apache CouchDB on CentOS 8.

Now we add CouchDB Repository on your CentOS system:

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

[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

Next, install the CouchDB packages by running the following command:

sudo dnf install couchdb

After installation, enable and start the CouchDB service by issuing the commands below:

sudo systemctl enable --now couchdb

Step 3. Configuration of CouchDB on CentOS 8.

The configuration files for CouchDB are stored in the /opt/couchdb directory. To create an admin account open the local.ini file and add a line under the [admins] section using the format username = password. Restart the CouchDB service to change the plain text password to a hash for security purposes.

Step 4. Configure Firewall.

If you are running firewalld on the server, you must open port 5984 to allow traffic CouchDB:

firewall-cmd --zone=public --permanent --add-port=5984/tcp
firewall-cmd --reload

Step 5. Accessing the CouchDB Web Interface.

Apache CouchDB should be running at localhost:5984. To confirm that CouchDB is working as expected, use the curl command to print CouchDB’s information in JSON format:

curl http://127.0.0.1:5984/

Congratulations! You have successfully installed Apache CouchDB. Thanks for using this tutorial for installing Apache CouchDB on CentOS 8 systems. For additional help or useful information, we recommend you check the official Apache CouchDB website.