From e7587965fd30306d5552b23b89836460ca5ca3de Mon Sep 17 00:00:00 2001 From: Antoine Cotten Date: Fri, 18 Nov 2022 21:40:27 +0100 Subject: [PATCH] doc: Describe how to re-execute the setup after init --- README.md | 30 ++++++++++++++++++++++++++++++ 1 file changed, 30 insertions(+) diff --git a/README.md b/README.md index 85a9101..1bb5744 100644 --- a/README.md +++ b/README.md @@ -63,6 +63,7 @@ own_. [sherifabdlnaby/elastdocker][elastdocker] is one example among others of p * [How to configure Logstash](#how-to-configure-logstash) * [How to disable paid features](#how-to-disable-paid-features) * [How to scale out the Elasticsearch cluster](#how-to-scale-out-the-elasticsearch-cluster) + * [How to re-execute the setup](#how-to-re-execute-the-setup) * [How to reset a password programmatically](#how-to-reset-a-password-programmatically) 1. [Extensibility](#extensibility) * [How to add plugins](#how-to-add-plugins) @@ -328,6 +329,35 @@ You can also cancel an ongoing trial before its expiry date — and thus revert Follow the instructions from the Wiki: [Scaling out Elasticsearch](https://github.com/deviantony/docker-elk/wiki/Elasticsearch-cluster) +### How to re-execute the setup + +To run the setup container again and re-initialize all users for which a password was defined inside the `.env` file, +delete its volume and "up" the `setup` Compose service again manually: + +```console +$ docker-compose rm -f setup + ⠿ Container docker-elk-setup-1 Removed +``` + +```console +$ docker volume rm docker-elk_setup +docker-elk_setup +``` + +```console +$ docker-compose up setup + ⠿ Volume "docker-elk_setup" Created + ⠿ Container docker-elk-elasticsearch-1 Running + ⠿ Container docker-elk-setup-1 Created +Attaching to docker-elk-setup-1 +... +docker-elk-setup-1 | [+] User 'monitoring_internal' +docker-elk-setup-1 | ⠿ User does not exist, creating +docker-elk-setup-1 | [+] User 'beats_system' +docker-elk-setup-1 | ⠿ User exists, setting password +docker-elk-setup-1 exited with code 0 +``` + ### How to reset a password programmatically If for any reason your are unable to use Kibana to change the password of your users (including [built-in