How To Install Apache CouchDB on CentOS 8

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.


  • 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

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:


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.

VPS Manage Service Offer
If you don’t have time to do all of this stuff, or if this is not your area of expertise, we offer a service to do “VPS Manage Service Offer”, starting from $10 (Paypal payment). Please contact us to get the best deal!


r00t is a seasoned Linux system administrator with a wealth of experience in the field. Known for his contributions to idroot.us, r00t has authored numerous tutorials and guides, helping users navigate the complexities of Linux systems. His expertise spans across various Linux distributions, including Ubuntu, CentOS, and Debian. r00t's work is characterized by his ability to simplify complex concepts, making Linux more accessible to users of all skill levels. His dedication to the Linux community and his commitment to sharing knowledge makes him a respected figure in the field.
Back to top button