Skip to content 
Running ArangoDB Made Simple: Step-by-Step Guide
docker run -p 8529:8529 arangodb/arangodb
I've created an automated build repository on docker, so that you can easily start a docker container with the latest stable release. If you miss anything in the container, please let me know. Thanks to frodenas, hipertracker, joaodubas, webwurst who also created dockerfiles.
ArangoDB
A distributed open-source database with a flexible data model for documents, graphs, and key-values. Build high performance applications using a convenient sql-like query language or JavaScript extensions.
Start a ArangoDB instance
In order to start an ArangoDB instance run
unix> docker run --name arangodb-instance -d arangodb/arangodb
By default ArangoDB listen on port 8529 for request and the image includes EXPOST 8529. If you link an application container, it is automatically available in the linked container. See the following examples.
Using the instance
In order to use the running instance from an application, link the container
unix> docker run --name my-app --link arangodb-instance
Running the image
In order to start an ArangoDB instance run
unix> docker run -p 8529:8529 -d arangodb/arangodb
ArangoDB listen on port 8529 for request and the image includes EXPOST 8529. The -p 8529:8529 exposes this port on the host.
Command line options
In order to get a list of supported options, run
unix> docker run -e help=1 arangodb/arangodb
Persistent Data
ArangoDB use the volume /data as database directory to store the collection data and the volume /apps as apps directory to store any extensions. These directory are marked as docker volumes.
See docker run -e help=1 arangodb for all volumes.
A good explanation about persistence and docker container can be found here: Docker In-depth: Volumes, Why Docker Data Containers are Good Using host directories
Using host directories
You can map the container's volumes to a directory on the host, so that the data is kept between runs of the container. This path /tmp/arangodb is in general not the correct place to store you persistent files - it is just an example!
unix> mkdir /tmp/arangodb
unix> docker run -p 8529:8529 -d \
-v /tmp/arangodb:/data \
arangodb
This will use the /tmp/arangodb directory of the host as database directory for ArangoDB inside the container. Using a data container
Using a data container
Alternatively you can create a container holding the data.
unix> docker run -d --name arangodb-persist -v /data ubuntu:14.04 true
And use this data container in your ArangoDB container.
unix> docker run --volumes-from arangodb-persist -p 8529:8529 arangodb
unix> docker run -d --name arangodb-persist -v /data tianon/true true
Images
Building an image
Simple clone the repository and execute the following command in the arangodb-docker folder
unix> docker build -t arangodb .
This will create a image named arangodb.
ArangoDB 2.2.7 Release: Enhancements & Bug Fixes
This version is deprecated. Download the new version of ArangoDB
A maintenance release for ArangoDB 2.2 is available from the usual channels.
v2.2.7 (2014-11-19)
- fixed issue #1079: AQL editor: keyword WITH in UPDATE query is not highlighted
- fix memory leak in cluster nodes
- fixed registration of AQL user-defined functions in Web UI (JS shell)
- fixed error display in Web UI for certain errors (now error message is printed instead of ‘undefined’)
- fixed issue #1059: bug in js module console
- fixed issue #1056: “fs”: zip functions fail with passwords
- fixed issue #1063: Docs: measuring unit of –wal.logfile-size?
- fixed issue #1062: Docs: typo in 14.2 Example data
The 2.2.7 Documentation: Click here
ArangoDB Cookbook: Recipes for Database Optimization
It’s new – and just for you! With the new ArangoDB Cookbook we want to guide you thru various challenges that might arise in your daily business with NoSQL – and ArangoDB in particular.
You have a problem with or need an introduction to NoSQL data modeling / scaling ArangoDB / building Foxx apps / graph processing or something related to your favorite programming language? Then have a look if there’s a recipe match in the Cookbook!
Create your own recipes and help others in the ArangoDB community. We appreciate every participation that makes the cookbook a valuable source for ArangoDB users. Just write your problem description and solution in plain markdown and start a pull request on Github.
Need an example?
Lets assume you checked the foxx introduction on our website and now you want to build your own Foxx app, but you don’t know how to start.
ArangoDB 2.3 Release: New Features & Enhancements
This version is deprecated. Download the new version of ArangoDB
The new query optimizer is ready to rock the world. We are proud to announce the release of ArangoDB 2.3, available for download now. ArangoDB 2.3 is available for Linux, Windows and Mac and provides support for 16 programming languages.
Overhauled Query Optimizer
The query optimizer and executor for AQL queries have been completely overhauled. Especially the optimization of distributed queries has been improved significantly.
The query optimizer can now apply much more optimizations than in previous versions of ArangoDB. We have tried to keep the new version as compatible as possible with ArangoDB 2.2.
Have a look at Jan’s blog post “Tour around new AQL query optimizer” or read the optimizer documentation to get familiar with this new feature.
Powerful Foxx Enhancements
We can’t wait to get your feedback, so we’ve released some great new Foxx features in 2.3 with more to come in the next release.
With the new job queues feature you can run async jobs to communicate with external services, Foxx queries make writing complex AQL queries much easier and Foxx sessions will handle the authentication and session hassle for you. (more…)
ArangoDB Java Driver for Graphs: Enhanced Functionality
After defining a graph and filling it with some vertices and edges (see part 1), the time has come to retrieve information out of the graph.
Please take a look at the defined graph operations of ArangoDB. These will be the base for our next examples. (Yes, there may be other ways to get the results, this post does not claim completeness!)
We will start with some easy stuff and then smoothly advance in complexity.
Question: “How many edges are defined within the graph?”
Introduction to the Pregel Module in ArangoDB
This post is outdated, please see more recent infos below.
Please see a technical article about our current Pregel integration in our blog, details about the various Pregel algorithms ArangoDB supports in our documentation and a tutorial about Community Detection with real data in our training center.
Ever since Google introduced Pregel as a system for large-scale graph processing we thought of a way how to enable this feature in ArangoDB. So we set up an ArangoDB cluster, created some huge graphs and started evaluating the concept. We came up with a new ArangoDB module (called pregelRunner) that enables the user to write own algorithms, pass them to ArangoDB and have them executed in a Pregel-like fashion.
This means that the user’s algorithm is executed step wise on each server in the cluster in parallel for all its local vertices. In each step the vertices can send messages to each other to distribute information. These messages can be received by the other vertex in the next step. The algorithm terminates when there are no more active vertices left and no message has been sent.
We started to implement an experimental version of Pregel in ArangoDB. You need to check-out the pregel branch of ArangoDB in order to play with the following examples. Please be advised that the implementation is still in an early phase and very like to change. In this post we will provide a brief introduction to ArangoDB’s Pregel module by guiding you through the implementation of an example algorithm.
ArangoDB Java Driver: Graph Data Manipulation & Queries
With ArangoDB 2.2 the new graph API was released featuring multi collection graphs (see blog). With the new version (2.2.1) of arangodb-java-driver the new graph API is supported. In the following you can find a small example of creating a graph with Java.
For the import via maven and configuring the driver, please read the Basics and Driver Setup. For the following we assume, that arangodbDriver is a configured instance of the driver.
So let’s start the whole thing…
ArangoDB Java Driver: Batch & Asynchronous Mode | ArangoDB Blog
The current arangodb-java-driver supports the usage of ArangoDB’s batch and asynchronous interface. This post will guide you through the usage of these features.
The batch interface
The batch interface enables the user to stack a series of calls and execute them in a batch request. Each stacked request returns a request id that can be used to retrieve the single results from the batch response. So how do you use this feature in the java driver ?
First we create an instance of the java driver:
ArangoConfigure configure = new ArangoConfigure();
configure.init();
ArangoDriver driver = new ArangoDriver(configure);
ArangoDB Java Driver: Simplifying Database Interactions
A new arangodb-java-driver is out now, it’s on github. The driver is available for ArangoDB from version 2.2 onwards.
How to include the driver in your application ?
The driver is available as maven artifact. To add the driver to your project with maven, add the following code to your pom.xml:
<dependencies>
<dependency>
<groupId>com.arangodb</groupId>
<artifactId>arangodb-java-driver</artifactId>
<version>2.2</version>
</dependency>
....
</dependencies>
Tour Around the New AQL Query Optimizer | ArangoDB Blog
The major new feature in ArangoDB 2.3 is the shiny new AQL query optimizer and executor. These parts of ArangoDB have been rewritten in 2.3 to make AQL much better for our end users.
Since one of the initial releases, ArangoDB has been shipped with AQL, the ArangoDB Query Language. AQL has since then been ArangoDB’s most versatile way of executing simple and also the not-so-simple queries.
I’ll start with an overview of query execution in previous versions of ArangoDB, and then explain the new engine and explain the differences.
Get the latest tutorials,
blog posts and news:
Thanks for subscribing! Please check your email for further instructions.