arangodb/Documentation/Books/Manual

page-toc
disable true

ArangoDB VERSION_NUMBER Documentation

Welcome to the ArangoDB documentation!

{% hint 'info' %} New and eager to try out ArangoDB? Start right away with our beginner's guide: Getting Started {% endhint %}

Structure

The documentation is organized in five handbooks:

• This manual describes ArangoDB and its features in detail for you as a user, developer and administrator.
• The AQL handbook explains ArangoDB's query language AQL.
• The HTTP handbook describes the internal API of ArangoDB that is used to communicate with clients. In general, the HTTP handbook will be of interest to driver developers. If you use any of the existing drivers for the language of your choice, you can skip this handbook.
• Our Cookbook with recipes for specific problems and solutions.
• The Driver handbook includes the documentation of the available official ArangoDB drivers and integrations, and an overview of the community drivers.

Features are illustrated with interactive usage examples; you can cut'n'paste them into arangosh to try them out. The HTTP REST-API for driver developers is demonstrated with cut'n'paste recipes intended to be used with the cURL. Drivers may provide their own examples based on these .js based examples to improve understandability for their respective users, i.e. for the java driver some of the samples are re-implemented.

Key Features

ArangoDB is a native multi-model, open-source database with flexible data models for documents, graphs, and key-values. Build high performance applications using a convenient SQL-like query language or JavaScript extensions. Use ACID transactions if you require them. Scale horizontally and vertically with a few mouse clicks.

Key features include:

• installing ArangoDB on a cluster is as easy as installing an app on your mobile
• Flexible data modeling: model your data as combination of key-value pairs, documents or graphs - perfect for social relations
• Powerful query language (AQL) to retrieve and modify data
• Use ArangoDB as an application server and fuse your application and database together for maximal throughput
• Transactions: run queries on multiple documents or collections with optional transactional consistency and isolation
• Replication and Sharding: set up the database in a master-slave configuration or spread bigger datasets across multiple servers
• Configurable durability: let the application decide if it needs more durability or more performance
• No-nonsense storage: ArangoDB uses all of the power of modern storage hardware, like SSD and large caches
• JavaScript for all: no language zoo, you can use one language from your browser to your back-end
• ArangoDB can be easily deployed as a fault-tolerant distributed state machine, which can serve as the animal brain of distributed appliances
• It is open source (Apache License 2.0)

Community

If you have questions regarding ArangoDB, Foxx, drivers, or this documentation don't hesitate to contact us on:

• GitHub for issues and misbehavior or pull requests
• Google Groups for discussions about ArangoDB in general or to announce your new Foxx App
• StackOverflow for questions about AQL, usage scenarios etc.
• Slack, our community chat

When reporting issues, please describe:

• the environment you run ArangoDB in
• the ArangoDB version you use
• whether you're using Foxx
• the client you're using
• which parts of the documentation you're working with (link)
• what you expect to happen
• what is actually happening

We will respond as soon as possible.