From 4420ce1e8264b6be38bd4c7e4c4a5e703ff4bd3a Mon Sep 17 00:00:00 2001 From: Antoine Cotten Date: Tue, 27 Jun 2017 11:48:32 +0200 Subject: [PATCH] Warn about bind mount pitfalls ref #115 --- README.md | 11 ++++++++++- 1 file changed, 10 insertions(+), 1 deletion(-) diff --git a/README.md b/README.md index 991c6eb..923b857 100644 --- a/README.md +++ b/README.md @@ -75,7 +75,7 @@ You can also choose to run it in background (detached mode): $ docker-compose up -d ``` -Give Elasticsearch about a minute to initialize, then access the Kibana web UI by hitting +Give Kibana about 2 minutes to initialize, then access the Kibana web UI by hitting [http://localhost:5601](http://localhost:5601) with a web browser. By default, the stack exposes the following ports: @@ -186,6 +186,15 @@ elasticsearch: This will store Elasticsearch data inside `/path/to/storage`. +**NOTE:** beware of these OS-specific considerations: +* **Linux:** the [unprivileged `elasticsearch` user][esuser] is used within the Elasticsearch image, therefore the + mounted data directory must be owned by the uid `1000`. +* **macOS:** the default Docker for Mac configuration allows mounting files from `/Users/`, `/Volumes/`, `/private/`, + and `/tmp` exclusively. Follow the instructions from the [documentation][macmounts] to add more locations. + +[esuser]: https://github.com/elastic/elasticsearch-docker/blob/016bcc9db1dd97ecd0ff60c1290e7fa9142f8ddd/templates/Dockerfile.j2#L22 +[macmounts]: https://docs.docker.com/docker-for-mac/osxfs/ + ## Extensibility ### How can I add plugins?