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.
- 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).
non-root sudo useror 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:
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:
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 22.214.171.124, 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
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:
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.