Arango logo

ArangoDB v4.x is under development and not released yet.

This documentation is not final and potentially incomplete.

Installing ArangoDB on Linux

Download and extract the tar.gz archives of the server and the client tools

You can install ArangoDB on most common Linux distributions. The basic installation steps are:

  1. Visit the official Download  page of the ArangoDB website.

  2. Download the server package and, if you need them, the client tools package for your processor architecture (x86-64 or ARM64). The packages are generic tar.gz archives that work across Linux distributions.

  3. You may verify the integrity of a download by comparing the SHA256 hash listed on the website with the hash of the file. For example, you can run openssl sha256 <filename> or sha256sum <filename> in a terminal.

  4. Unpack the archives, for example, by running tar -xzf <filename>, and add the bin directories of the unpacked archives to your PATH environment variable.

  5. You can start ArangoDB in several ways, depending on the type of ArangoDB deployment you are interested in (Single Server, Cluster). Please refer to the Deploy chapter for details.

Securing your Installation

To set a password for the root user before you start the server for the first time, initialize the database directory with the following command. Use the same database directory as for starting the server afterwards:

ARANGODB_DEFAULT_ROOT_PASSWORD=NEWPASSWORD arangod --database.directory /path/to/data --database.init-database true

If you don’t set the ARANGODB_DEFAULT_ROOT_PASSWORD environment variable, you are prompted for the password. The server shuts down after initializing the database directory.

To set a new password for the root user of an existing database directory, stop the server and run the following command:

ARANGODB_DEFAULT_ROOT_PASSWORD=NEWPASSWORD arangod --database.directory /path/to/data --database.restore-admin true
Using the --database.restore-admin startup option removes all database users but root.