This guide explains how to launch the Elasticsearch backend and Argilla Server using
docker. Please check the setup and installation section to understand other options.
First, you need to create a network to make both standalone containers visible between them. Just run the following command:
docker network create argilla-net
Setting up Elasticsearch (ES) via docker is straightforward. Simply run the following command:
docker run -d --name elasticsearch-for-argilla --network argilla-net -p 9200:9200 -p 9300:9300 -e "ES_JAVA_OPTS=-Xms512m -Xmx512m" -e "discovery.type=single-node" -e "xpack.security.enabled=false" docker.elastic.co/elasticsearch/elasticsearch:8.5.3
This will create an ES docker container named “elasticsearch-for-argilla” that will run in the background.
To see the logs of the container, you can run:
docker logs elasticsearch-for-argilla
Or you can stop/start the container via:
docker stop elasticsearch-for-argilla
docker start elasticsearch-for-argilla
Keep in mind that if you remove your container with
docker rm elasticsearch-for-argilla
you will lose all your datasets in Argilla!
We recommend ES version 8.5.x to work with Argilla.
Argilla Server and UI#
You can use vanilla docker to run our image of Argilla Server. First, pull the image from the Docker Hub:
docker pull argilla/argilla-server
Then simply run it.
Keep in mind that you need a running Elasticsearch instance for Argilla to work.
By default, the Argilla server will look for your Elasticsearch endpoint at
But you can customize this by setting the
ARGILLA_ELASTICSEARCH environment variable.
docker run --network argilla-net -p 6900:6900 -e "ARGILLA_ELASTICSEARCH=http://elasticsearch-for-argilla:9200" --name argilla argilla/argilla-server
By default, telemetry is enabled. This helps us to improve our product. For more info about the metrics and disabling them check telemetry.
To find running instances of the Argilla server, you can list all the running containers on your machine:
To stop the Argilla server, just stop the container:
docker stop argilla
If you want to deploy your own Elasticsearch cluster via docker, we refer you to the excellent guide on the Elasticsearch homepage.