2.3 C
Saturday, January 16, 2021

How to install Apache CouchDB on CentOS 8?

Must read

Please Donate

Senior Writer and partner

In this post, I will show you how to install CouchDB on CentOS 8.

CouchDB is a database manager for the web. It takes care of saving and storing NoSQL type data for server-side applications. It is widely used and its learning curve is very low.

On the other hand, CouchDB places a lot of emphasis on data replication as a persistent way to obtain data. That is, we will be able to connect multiple nodes and from there do the replication.

Of course, there are a lot of features and reasons why this project of the Apache Foundation is so important today.

So, let us start.

Install CouchDB on CentOS 8

There are several ways to install CouchDB on CentOS 8. Perhaps the most complex is to compile the program ourselves. Of course, this option guarantees that you always get the latest stable version.

On the other hand, there is the option of downloading and installing pre-compiled binary packages. And finally, we can install CouchDB on CentOS using the application repository. This last one will be the option to choose.

So let’s get started.

First, we need to add the CouchDB repository for CentOS 8. To do this, we need to create a text file in the system’s repository directory.

:~$ su
:~# nano /etc/yum.repos.d/bintray-apache-couchdb-rpm.repo

And in it, add the following content:

1.- Adding the couchDB repository
1.- Adding the couchDB repository

Save the file and close it.

Then, the EPEL repository must be enabled. You can do it quickly, with the following command

:~# dnf install epel-release

If you want more information about how to enable the EPEL repository, I recommend you to read our post:

How to enable the EPEL repository on CentOS 8?

After this, we can install couchDB with the following command:

:~# dnf install couchdb
2.- Install CouchDB on CentOS 8
2.- Install CouchDB on CentOS 8

And that’s it. However, before using it, there are some settings to be made.

Preparing CouchDB for the first use

Remember that CouchDB works through port 5984. So, the first thing is to open that port in the firewall.

:~# firewall-cmd --add-port=5984/tcp --permanent --zone=public

And then, restart the firewall to apply the changes.

:~# firewall-cmd --reload

Now we have to enable the CouchDB web interface.

So, open the CouchDB configuration file and find the admins section and set a password there for the admin user.

:~# nano /opt/couchdb/etc/local.ini
admin = your-password
3.- Set a new password for the admin user
3.- Set a new password for the admin user

Then go to the chttpd section in the same file and uncomment the port and bind_address lines. In the port you can change the default port of the application. And in Bind_address the IP address that serves the interface. If you are going to use a cluster, you must type

port = 5984
bind_address =
4.- Enabling the web interface of CouchDB on CentOS 8
4.- Enabling the web interface of CouchDB on CentOS 8

Now if you can, save and close the file.

Finally, the CouchDB service begins. It is also a good idea to enable it to start with the system.

:~# systemctl enable couchdb
:~# systemctl start couchdb

CouchDB on CentOS 8

Now open your favorite web browser and go to http://your-server:5984/_utils and you will see the Login screen.

5.- Couchdb login screen
5.- Couchdb login screen

Just type your credentials and click on the Log in button. You will see this:

6.- CouchDB on CentOS 8
6.- CouchDB on CentOS 8

Finally, you can test the installation.

7.- CouchDB ready for the work
7.- CouchDB ready for the work

So, enjoy it.


CouchDB is clearly oriented to the professional web sector. However, its learning curve is low with respect to its power. Despite this, CouchDB is easily installable as we have seen.

Apache CouchDB documentation

Please share this post with your friends and join our Telegram Channel.

More articles


Please enter your comment!
Please enter your name here


Latest article