Apache CouchDB is an open-source NoSQL database released by the Apache Software Foundation. It uses JSON to represent data stored in a database. The CouchDB replication allows you to synchronize two or more CouchDB databases. CouchDB RESTful HTTP/JSON API allows you to read, edit, delete and create database documents. In this tutorial, we’ll explain how to install CouchDB on Ubuntu 22.04.
Step 1 – Update System
First of all, you need to check for system update and if any package update available you have to update by issuing below given command:
sudo apt update && upgrade
Step 2 – Install Dependency
Use following command to install dependency:
sudo apt install -y curl apt-transport-https gnupg
Step 3 – Enabling CouchDB repository
First of all we will enable the CouchDB repository and import GPG key as root or user with sudo privileges:
curl https://couchdb.apache.org/repo/keys.asc | gpg –dearmor | sudo tee /usr/share/keyrings/couchdb-archive-keyring.gpg >/dev/null 2>&1
echo "deb [signed-by=/usr/share/keyrings/couchdb-archive-keyring.gpg] https://apache.jfrog.io/artifactory/couchdb-deb/ ${VERSION_CODENAME} main" | sudo tee /etc/apt/sources.list.d/couchdb.list >/dev/null
Step 4 – Install CouchDB
After enabling the repository, update the packages list and install CouchDB:
sudo apt update
sudo apt install -y couchdb
Installer will prompt you to choose option whether you want to install CouchDB in a standalone or clustered mode. We’ll install the CouchDB in a single-server standalone mode.
Next, you can set IP address on which CouchDB will bind. Leave it as default value 127.0.0.1. If you are configuring a cluster, enter the interface IP address or type 0.0.0.0, which tells CouchDB to binds to all network interfaces.
After that, set the password for admin. If you leave this field blank it will not create admin user. It is highly recommended to set the password, and take CouchDB out of the insecure “admin party” mode.
Again enter the password to confirm and the installation will continue.
At this point, the installation is completed.
Step 5 – Verify Installation
The CouchDB server will run at localhost:5984. Run the following curl command to display information about the CouchDB database in JSON format:
curl http://127.0.0.1:5984/
If it will print output as following means that the installation was successful and the service is running.
{
"couchdb":"Welcome",
"version":"3.2.2",
"git_sha":"ff0feea20",
"uuid":"4589130c33b0dae4c166330463542ad4",
"features":[
"access-ready",
"partitioned",
"pluggable-storage-engines",
"reshard",
"scheduler"
],
"vendor":{
"name":"The Apache Software Foundation"
}
}
Enter url http://127.0.0.1:5984/_utils/ to your web browser to access the CouchDB web-based interface. It will show as following:
Conclusion
That’s it. We have successfully learned how to install CouchDB on Ubuntu 22.04 system. To learn more, take a look at Apache CouchDB Documentation.
Feel free to leave comment if you have any question or suggestion.