Deployments

This chapter describes various possibilities to deploy ArangoDB

ArangoDB supports many resilient deployment modes to meet the exact needs of your project.

For installation instructions, please refer to the Installation Chapter.

For production deployments, please also carefully check the ArangoDB Production Checklist.

By ArangoDB Deployment Mode

ArangoDB can be deployed in different configurations, depending on your needs.

Single Instance

A Single Instance deployment is the most simple way to get started. Unlike other setups, which require some specific procedures, deploying a stand-alone instance is straightforward and can be started manually or by using the ArangoDB Starter tool.

Active Failover

Active Failover deployments use ArangoDB’s multi-node technology to provide high availability for smaller projects with fast asynchronous replication from the leading node to multiple replicas. If the leader fails, then a replicant takes over seamlessly.

Cluster

Cluster deployments are designed for large scale operations and analytics, allowing you to scale elastically with your applications and data models. ArangoDB’s synchronously-replicating cluster technology runs on premises, on Kubernetes, and in the cloud on ArangoGraph - ArangoDB’s fully managed service.

Clustering ArangoDB not only delivers better performance and capacity improvements, but it also provides resilience through replication and automatic failover. You can deploy systems that dynamically scale up and down according to demand.

Datacenter-to-Datacenter

With ArangoDB’s Datacenter-to-Datacenter support, you can replicate your data to any other datacenter. The leading datacenter asynchronously replicates to any number of following datacenters for optimal write performance.

By Technology

There are different ways that can be used to deploy an environment. You can manually start all the needed processes localy or in Docker containers. Or use the ArangoDB Starter, the arangodb binary program, for local setups using processes or Docker containers.

If you want to deploy in your Kubernetes cluster, you can use the ArangoDB Kubernetes Operator (kube-arangodb).

The fastest way to get ArangoDB up and running is to run it in the cloud - the ArangoGraph Platform offers a fully managed cloud service, available on AWS, Microsoft Azure, and Google Cloud Platform.

Manual Deployment

Single Instance:

Active Failover:

Cluster:

Deploying using the ArangoDB Starter

Setting up an ArangoDB cluster, for example, involves starting various nodes with different roles (Agents, DB-Servers, and Coordinators). The starter simplifies this process.

The Starter supports different deployment modes (single server, Active Failover, cluster) and it can either use Docker containers or processes (using the arangod executable).

Besides starting and maintaining ArangoDB deployments, the Starter also provides various commands to create TLS certificates and JWT token secrets to secure your ArangoDB deployments.

The ArangoDB Starter is an executable called arangodb and comes with all current distributions of ArangoDB.

If you want a specific version, download the precompiled executable via the GitHub releases page.

Single Instance:

Active Failover:

Cluster:

In the Cloud

Kubernetes