deviantony /docker-elk
The Elastic stack (ELK) powered by Docker and Compose.
★ 18,381⑂ 6,837👁 322⑃ 591● 619▤ 15
+0
Daily
18,381
stars
6,837
forks
322
watchers
591
prs
619
issues
15
releases
README
Elastic stack (ELK) on Docker
Run the latest version of the [Elastic stack][elk-stack] with Docker and Docker Compose.
It gives you the ability to analyze any data set by using the searching/aggregation capabilities of Elasticsearch and
the visualization power of Kibana.
Based on the [official Docker images][elastic-docker] from Elastic:
Elasticsearch
Logstash
Kibana
Other available stack variants:
tls: TLS encryption enabled in Elasticsearch, Kibana (opt in),
and Fleet
[!IMPORTANT]
[Platinum][subscriptions] features are enabled by default for a [trial][license-mngmt] duration of 30 days. After
this evaluation period, you will retain access to all the free features included in the Open Basic license seamlessly,
without manual intervention required, and without losing any data. Refer to the How to disable paid
features section to opt out of this behaviour.
---
tl;dr
sh
docker compose up setup
sh
docker compose up
---
Philosophy
The main goal of docker-elk is to make the Elastic stack as easy as possible to get into. It is not a blueprint for a
production-ready deployment, but rather a _template_ that promotes tweaking and exploration.
The authors believe in good documentation over elaborate automation. The project's default configuration is purposely
minimal and unopinionated. The initial setup does not rely on any external dependency, and uses as little scripting as
necessary to get things up and running.
---
Contents
1. Requirements
Host setup
Docker Desktop
Windows
macOS
1. Usage
Bringing up the stack
Initial setup
Setting up user authentication
Injecting data
Cleanup
Version selection
1. Configuration
How to configure Elasticsearch
How to configure Kibana
How to configure Logstash
How to disable paid features
How to scale out the Elasticsearch cluster
How to re-execute the setup
How to reset a password programmatically
1. Extensibility
How to add plugins
How to enable the provided extensions
1. JVM tuning
How to specify the amount of memory used by a service
How to enable a remote JMX connection to a service
1. Going further
Plugins and integrations
Requirements
Host setup
[Docker Engine][docker-install] version 18.06.0 or newer
[Docker Compose][compose-install] version 2.0.0 or newer
1.5 GB of RAM
[!NOTE]
Especially on Linux, make sure your user has the [required permissions][linux-postinstall] to interact with the Docker
daemon.
By default, the stack exposes the following ports:
5044: Logstash Beats input
50000: Logstash TCP input
9600: Logstash monitoring API
9200: Elasticsearch HTTP
9300: Elasticsearch TCP transport
5601: Kibana
[!WARNING]
Elasticsearch's [bootstrap checks][bootstrap-checks] were purposely disabled to facilitate the setup of the Elastic
stack in development environments. For production setups, we recommend users to set up their host according to the
instructiTop issues
#579Persist elasticsearch.keystore or add data before the first container starts?15 comments · 2021-02-28#1105Security Risk Assessment1 comments · 2025-09-06#668Elasticsearch throws a warning because Transport SSL isn't enabled1 comments · 2022-02-11#550Mention possible challenges with UFW and firewalld1 comments · 2020-11-07#1118elk relation is what?0 comments · 2025-10-17
Latest release
9.2511.1 9.2511.1 2025-11-06Default Elastic version: 9.2.0 Note _See version selection to run a different version._ Notable changes - A new Compose service kibana-genkeys allows generating encryption keys for Kibana.