Before installing Arranger, please ensure that you have Docker installed on your system. You can find dockers official download and installation instructions here.

Docker Installation

To install Arranger using Docker, follow these steps:

  1. Clone the Arranger repository from your command line terminal:
git clone
  1. Navigate to the project directory:
cd arranger
  1. With Docker running, execute the quickstart make target:
make start

The make start command deploys the following services:

  • Arranger-server: The server-side application

  • Elasticsearch: Configured with default username elastic and password myelasticpassword. For more details on modifying these values prior to deployment, refer to our documentation on configuring Elasticsearch.

  • **Kibana**: Elastic's tool for visualizing indices

If the installation is successful, you should see the following message:

⠿ Container arranger-server.local Started
⠿ Container arranger-elasticsearch Started
⠿ Container arranger-kibana Started
**************** Succesfully started all Arranger services!
You may have to populate ES and restart the Server container. (Use 'make seed-es' for mock data)

Please refer to the docker-compose.yml file for version specifications.

The deployed services will be accessible through the following ports:

Arranger Serverlocalhost:5050/graphql

When accessing arranger-server via localhost:5050, you may encounter the following error message:

{"error":"The GraphQL server is unavailable due to an internal error","message":"Something went wrong while creating the GraphQL schemas"}

To resolve this, we need to configure and supply an index mapping to Elasticsearch. This will be covered in the next section.