How To Install ArangoDB on Ubuntu 16.04 LTS

In this tutorial, we will show you how to install ArangoDB on Ubuntu 16.04 LTS. For those of you who didn’t know, the Arango database (ArangoDB) is a multi-model database program, meaning one which uses a combination of Key-Value pairs, files, and graphs to store info. It has a flexible information model for files and graphs. It is a general-purpose database and gives all attributes which are necessary for a contemporary web application.

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 ArangoDB on an Ubuntu 16.04 (Xenial Xerus) server.

Prerequisites

• A server running one of the following operating systems: Ubuntu 16.04 (Xenial Xerus).
• It’s recommended that you use a fresh OS install to prevent any potential issues.
• SSH access to the server (or just open Terminal if you’re on a desktop).
• 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 ArangoDB on Ubuntu 16.04 LTS

Step 1. First, make sure that all your system packages are up-to-date by running the following apt-get commands in the terminal.

sudo apt-get update
sudo apt-get upgrade

Step 2. Installing ArangoDB.

By default, ArangoDB is not available in the Ubuntu repository, so you will need to add the ArangoDB repository to your system:

wget https://www.arangodb.com/repositories/arangodb3/xUbuntu_16.04/Release.key

Now add the key with the following command:

apt-key add Release.key

Next, add the ArangoDB repository to sources.list and update the system again:

apt-add-repository 'deb https://www.arangodb.com/repositories/arangodb3/xUbuntu_16.04/ /'
apt-get update -y

Next, install ArangoDB by running the following command:

apt-get install arangodb3 -y

Once the installation is complete, start the arangodb3 service with the following command:

systemctl start arangodb3
systemctl enable arangodb3

Step 3. Access ArangoDB CLI.

ArangoDB comes with arangosh that provides a command-line shell to access the database. You can create new databases, users, collections, and documents, and perform all administrative tasks using this client:

arangosh

When asked for a password, enter the root password. You should see the following output:

__ _ _ __ __ _ _ __ __ _ ___ ___| |__ 
 / _` | '__/ _` | '_ \ / _` |/ _ \/ __| '_ \ 
| (_| | | | (_| | | | | (_| | (_) \__ \ | | |
 \__,_|_| \__,_|_| |_|\__, |\___/|___/_| |_|
 |___/

arangosh (ArangoDB 3.0.12 [linux] 64bit, using VPack 0.1.30, ICU 54.1, V8 5.0.71.39, OpenSSL 1.0.2g-fips 1 Mar 2016)
Copyright (c) ArangoDB GmbH

Pretty printing values.
Connected to ArangoDB 'http+tcp://127.0.0.1:8529' version: 3.0.12 [server], database: '_system', username: 'root'

Please note that a new minor version '3.1.19' is available
Type 'tutorial' for a tutorial or 'help' to see common examples
127.0.0.1:8529@_system>

Step 4. Accessing ArangoDB Web Interface.

ArangoDB comes with a built-in, user-friendly web interface for performing administrative tasks. First, open the arangod.conf file located in the /etc/arangodb3/ directory:

nano /etc/arangodb3/arangod.conf

Add your server’s IP address as follows:

endpoint = tcp://192.168.1.227:8529

Next, open the arangosh.conf file located at /etc/arangodb3/ directory:

nano /etc/arangodb3/arangosh.conf

Again, add your server’s IP address:

endpoint = tcp://192.168.1.227:8529
authentication = true

Save the file and restart the ArangoDB service:

systemctl restart arangodb3

Finally, steps, Open your favorite web browser and type the URL http://192.168.0.227:8529. This will open up the login screen for the _system db. After entering your login credentials, you will see the ArangoDB splash screen. This concludes my tutorial.

Congratulations! You have successfully installed ArangoDB. Thanks for using this tutorial for installing ArangoDB on your Ubuntu 16.04 LTS. For additional help or useful information, we recommend you check the official ArangoDB website.