10.1 C
Amsterdam

How to install CouchDB on Ubuntu 20.04?

angeloma
angeloma
Senior Writer and partner

Hello, friends. In this post, you will learn how to install Apache CouchDB on Ubuntu 20.04. It will be easy to follow step by step guide.

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 Ubuntu 20.04

Apache CouchDB although it is an open-source application is not in the official Ubuntu repositories. But the installation is not complicated since there is a dedicated repository for Ubuntu.

So, open a terminal or start an SSH session on your server.

Then, update your entire distribution:

sudo apt update
sudo apt upgrade

Next, you can install some packages needed to complete this tutorial.

sudo apt-get install software-properties-common curl

Then, download and import the GPG key from the CouchDB repository.

curl -L https://couchdb.apache.org/repo/bintray-pubkey.asc | sudo apt-key add

Then we can add the repository:

echo "deb https://apache.bintray.com/couchdb-deb focal main" | sudo tee -a /etc/apt/sources.list

Then refresh APT to load the added repository:

sudo apt update

Now you can install CouchDB by running the following command:

sudo apt install couchdb
Reading package lists… Done
 Building dependency tree       
 Reading state information… Done
 The following additional packages will be installed:
   libmozjs-68-0
 The following NEW packages will be installed:
   couchdb libmozjs-68-0
 0 upgraded, 2 newly installed, 0 to remove and 1 not upgraded.
 Need to get 31.5 MB of archives.
 After this operation, 63.0 MB of additional disk space will be used.
 Do you want to continue? [Y/n]

During the installation, you will see some configuration screens.

The first one will ask you how to install CouchDB. It can be a single server or in the form of a Cluster. In this case, I will choose the first option:

1.- Configuring Apache CouchDB on Ubuntu 20.04
1.- Configuring Apache CouchDB on Ubuntu 20.04

Then you will have to configure the IP address where CouchDB will listen. As I am working with a remote server it is convenient to use either the IP address of the server or 0.0.0.0 to make it accessible from all interfaces.

2.- Installing Apache CouchDB on Ubuntu 20.04
2.- Installing Apache CouchDB on Ubuntu 20.04

Then configure a login password for the CouchDB user. You will have to enter it twice.

3.- Create the admin password
3.- Create the admin password

Afterward, the installation will be completed.

After the installation, you can check the status of the service.

sudo systemctl status couchdb
 ● couchdb.service - Apache CouchDB
      Loaded: loaded (/lib/systemd/system/couchdb.service; enabled; vendor preset: enabled)
      Active: active (running) since Mon 2020-12-14 15:29:45 CET; 25s ago
    Main PID: 2092 (beam.smp)
       Tasks: 36 (limit: 2286)
      Memory: 34.4M
      CGroup: /system.slice/couchdb.service
              ├─2092 /opt/couchdb/bin/../erts-9.3.3.14/bin/beam.smp -K true -A 16 -Bd -- -root /opt/couchdb/bin/.. -progname couchdb -- -home /opt/couchdb -- -boot /opt/>
              ├─2109 /opt/couchdb/bin/../erts-9.3.3.14/bin/epmd -daemon
              ├─2127 erl_child_setup 65536
              ├─2149 inet_gethost 4
              └─2150 inet_gethost 4
 Dec 14 15:29:45 test systemd[1]: Started Apache CouchDB.

Access to the Apache CouchDB web interface

Now open your web browser and go to http://your-server:5984/_utils

Note: You have to open port 5984 in your firewall for this to work.

The next thing you will see is the log in screen.

4.- Apache CouchDB login page
4.- Apache CouchDB login page

The user is admin and the password is the one you defined during the installation.

When you log in you will see the entire CouchDB dashboard where you can create new databases and manage them.

5.- Apache CouchDB working
5.- Apache CouchDB working

Conclusion

Apache CouchDB is a database manager clearly focused on the professional environment, but this does not prevent it from being used in learning and personal environments. So today you have learned how to install it on a server with Ubuntu 20.04.

- Advertisement -

LEAVE A REPLY

Please enter your comment!
Please enter your name here

Donate to Osradar

Latest article

x