Starting Manually

This section describes how to start an ArangoDB stand-alone instance by manuallystarting the needed process.

Local Start

We will assume that your IP is 127.0.0.1 and that the port 8529 is free:

  1. arangod --server.endpoint tcp://0.0.0.0:8529 \
  2. --database.directory standalone &

Manual Start in Docker

Manually starting a stand-alone instance via Docker is basically the same as describedin the paragraph above.

A bit of extra care has to be invested due to the way in which Docker isolates its network. By default it fully isolates the network and by doing so an endpoint like —server.endpoint tcp://0.0.0.0:8529will only bind to all interfaces inside the Docker container which does not includeany external interface on the host machine. This may be sufficient if you just wantto access it locally but in case you want to expose it to the outside you mustfacilitate Dockers port forwarding using the -p command line option. Be sure tocheck the official Docker documentation.

You can simply use the -p flag in Docker to make the individual processes available on the hostmachine or you could use Docker’s linksto enable process intercommunication.

An example configuration might look like this:

  1. docker run -e ARANGO_NO_AUTH=1 -p 192.168.1.1:10000:8529 arangodb/arangodb arangod \
  2. --server.endpoint tcp://0.0.0.0:8529\

This will start a single server within a Docker container with an isolated network. Within the Docker container it will bind to all interfaces (this will be 127.0.0.1:8529and some internal Docker IP on port 8529). By supplying -p 192.168.1.1:10000:8529we are establishing a port forwarding from our local IP (192.168.1.1 port 10000 inthis example) to port 8529 inside the container.

Authentication

To start the official Docker container you will have to decide on an authenticationmethod, otherwise the container will not start.

Provide one of the arguments to Docker as an environment variable. There are threeoptions:

  • ARANGO_NO_AUTH=1

Disable authentication completely. Useful for local testing or for operatingin a trusted network (without a public interface).

  • ARANGO_ROOT_PASSWORD=password

Start ArangoDB with the given password for root.

  • ARANGO_RANDOM_ROOT_PASSWORD=1

Let ArangoDB generate a random root password.

For an in depth guide about Docker and ArangoDB please check the official documentation:hub.docker.com/r/arangodb/arangodb/.Note that we are using the image arangodb/arangodb here which is always the most current one.There is also the “official” one called arangodb whose documentation is here:hub.docker.com/_/arangodb/{:target=”_blank”}