CouchDB is an open-source database, and was first released in 2005 and later became an Apache Software Foundation project in 2008. Apache CouchDB™ lets you access your data where you need it.
1. Upgrade your system
You need to upgrade your system software to the latest version before proceeding with the installation of CouchDB.
# yum update
Make sure the EPEL repository is present on the server, if it is not, try running this command.
# yum install epel-release
2. Add Apache repository
Before proceeding with the CouchDB installation, you may need to add the apache repository.
Create a file named apache.repo in the location /etc/yum.repos.d and edit the file and add the contents.
# vi /etc/yum.repos.d/apache.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
3. Install Apache CouchDB
Run the following command.
# yum install couchdb
4. Configure Apache CouchDB
When the installation is finished, run the following commands to start and enable CouchDB.
# systemctl start couchdb # systemctl enable couchdb
Verify the CouchDB is running or not by running the following command.
# systemctl status couchdb
You will get a output simialar as below if the installation was done properly.
# systemctl status couchdb ● couchdb.service - Apache CouchDB Loaded: loaded (/usr/lib/systemd/system/couchdb.service; enabled; vendor preset: disabled) Active: active (running) since Sun 2018-02-04 16:34:22 CST; 2min 33s ago Main PID: 1255 (beam.smp) CGroup: /system.slice/couchdb.service |─1255 /opt/couchdb/bin/../erts-7.3/bin/beam.smp -K true -A 16 -Bd -- -root /opt/couchdb/bin/.. -progname couchdb -- -home /opt/couchdb -- -boot /opt/co... ├─1263 /opt/couchdb/bin/../erts-7.3/bin/epmd -daemon ├─1478 sh -s disksup ├─1480 /opt/couchdb/bin/../lib/os_mon-2.4/priv/bin/memsup └─1481 /opt/couchdb/bin/../lib/os_mon-2.4/priv/bin/cpu_sup
6. Enable Fauxton Web GUI Administration Panel
Fauxton is a web-based interface built into CouchDB. It provides interface with the ability to manage documents, views and various configuration settings.
Modify the file:
# vi /opt/couchdb/etc/default.ini
Go to the line “[chttpd]” and edit the bind_address value with your IP address.
; These settings affect the main, clustered port (5984 by default).
port = 5984
bind_address = 126.96.36.199
# systemctl restart couchdb
Open the URL with your IP address in the web browser.
7. Creating an Administrator User in Fauxton
Open the URL with your IP address.
Enter your desired admin username and password.
That’s it. Now if you want to log in again the Fauxton Web GUI interface will ask you for your login credentials.