arangodb pulls statistics

Quick reference

• Maintained by: ArangoDB • Where to get help: the Docker Community Slack, Server Fault, Unix & Linux, or Stack Overflow

Supported tags and respective Dockerfile links

• 3.12, 3.12.12, latest

Quick reference (cont.)

• Where to file issues: https://github.com/arangodb/arangodb-docker/issues • Supported architectures: (more info) amd64, arm64v8 • Published image artifact details: repo-info repo's repos/arangodb/ directory (history) (image metadata, transfer size, etc) • Image updates: official-images repo's library/arangodb label official-images repo's library/arangodb file (history) • Source of this description: docs repo's arangodb/ directory (history)

What is ArangoDB?

ArangoDB is a scalable graph database system to drive value from connected data, faster. Native graphs, an integrated search engine, and JSON support, via a single query language.

ArangoDB runs everywhere: On-prem, in the cloud, and as a managed cloud service: ArangoGraph Insights Platform.

arangodb.com

Key Features in ArangoDB

Native Graph Store both data and relationships, for faster queries even with multiple levels of joins and deeper insights that simply aren't possible with traditional relational and document database systems.

Document Store Every node in your graph is a JSON document: flexible, extensible, and easily imported from your existing document database.

ArangoSearch Natively integrated cross-platform indexing, text-search and ranking engine for information retrieval, optimized for speed and memory.

ArangoDB Documentation

• Learn ArangoDB • Documentation

How to use this image

Start an ArangoDB instance

In order to start an ArangoDB instance, run:

Docker chooses the processor architecture for the image that matches your host CPU by default. If this is not the case, for example, because you have the DOCKER_DEFAULT_PLATFORM environment variable set to a different architecture, you can pass the --platform flag to the docker run command to specify the appropriate operating system and architecture for the container. For x86-64, use linux/amd64. On ARM, especially Apple silicon with no emulation for the required AVX instruction set extension, use linux/arm64/v8:

This creates and launches the arangodb Docker instance as a background process. The Identifier of the process is printed. By default, ArangoDB listens on port 8529 for requests.

In order to get the IP ArangoDB listens on, run:

Initialize the server language

When using Docker, you need to specify the language you want to initialize the server to on the first run in one of the following ways:

• Set the environment variable LANG to a locale in the docker run command, e.g. -e LANG=sv for a Swedish locale. • Use an arangod.conf configuration file that sets a language and mount it into the container. For example, create a configuration file on your host system in which you set icu-language = sv at the top (before any [section]) and then mount the file over the default configuration file like docker run -v /your-host-path/arangod.conf:/etc/arangodb3/arangod.conf ....

If you don't specify a language explicitly, the default is en_US up to ArangoDB v3.11 and en_US_POSIX from ArangoDB v3.12 onward.

Using the instance

To use the running instance from an application, link the container:

This uses the instance named arangodb-instance and links it into the application container. The application container contains environment variables, which can be used to access the database.

DB_LINK_PORT_8529_TCP=tcp://172.17.0.17:8529 DB_LINK_PORT_8529_TCP_ADDR=172.17.0.17 DB_LINK_PORT_8529_TCP_PORT=8529 DB_LINK_PORT_8529_TCP_PROTO=tcp DB_LINK_NAME=/naughty_ardinghelli/db-link

Exposing the port to the outside world

If you want to expose the port to the outside world, run:

ArangoDB listen on port 8529 for request and the image includes `EXPOSE 8529. The -p 8529:8529` exposes this port on the host.

Choosing an authentication method

The ArangoDB image provides several authentication methods which can be specified via environment variables (-e) when using docker run

1. ARANGO_RANDOM_ROOT_PASSWORD=1

Generate a random root password when starting. The password will be printed to stdout (may be inspected later using docker logs)

2. ARANGO_NO_AUTH=1

Disable authentication. Useful for testing.

WARNING Doing so in production will expose all your data. Make sure that ArangoDB is not directly accessible from the internet!

3. ARANGO_ROOT_PASSWORD=somepassword

Specify your own root password.

Note: this way of specifying logins only applies to single server installations. With clusters you have to provision the users via the root user with empty password once the system is up.

Command line options

You can pass arguments to the ArangoDB server by appending them to the end of the Docker command:

The entrypoint script starts the arangod binary by default and forwards your arguments.

You may also start other binaries, such as the ArangoShell:

Note that you need to set up networking for containers if arangod runs in one container and you want to access it with arangosh running in another container. It is easier to execute it in the same container instead. Use docker ps to find out the container ID / name of a running container:

It prints something similar to the following:

Then use docker exec and the ID / name to run something inside of the existing container:

For more information, see the ArangoDB documentation about Configuration.

Limiting resource utilization

arangod checks the following environment variables, which can be used to restrict how much memory and how many CPU cores it should use:

• ARANGODB_OVERRIDE_DETECTED_TOTAL_MEMORY *(introduced in v3.6.3)*…

Description from the Docker Hub listing.