From a11294ae9da0a802b252b594a942cab9630b25b8 Mon Sep 17 00:00:00 2001 From: Ivana Huckova <30407135+ivanahuckova@users.noreply.github.com> Date: Mon, 19 Jul 2021 11:23:38 -0400 Subject: [PATCH] Devenv: Update troubleshooting documentation (#36846) * Update Troubleshooting section * Update devenv/README.md Co-authored-by: Giordano Ricci * Update devenv/README.md Co-authored-by: Giordano Ricci * Update devenv/README.md Co-authored-by: achatterjee-grafana <70489351+achatterjee-grafana@users.noreply.github.com> Co-authored-by: Giordano Ricci Co-authored-by: achatterjee-grafana <70489351+achatterjee-grafana@users.noreply.github.com> --- devenv/README.md | 11 ++++------- 1 file changed, 4 insertions(+), 7 deletions(-) diff --git a/devenv/README.md b/devenv/README.md index 6478b9cf615..000d5463914 100644 --- a/devenv/README.md +++ b/devenv/README.md @@ -57,13 +57,10 @@ Jaeger block runs both Jaeger and Loki container. Loki container sends traces to ## Troubleshooting -### Containers fail to start (Mac OS) +### Containers that read from log files fail to start (Mac OS) + +If you are running Mac OSX, containers that read from the log files (e.g. Telegraf, Fileabeat, Promtail) can fail to start. This is because the default Docker for Mac does not have permission to create `grafana` folder at the `/var/log` location, as it runs as the current user. To solve this issue, manually create the folder `/var/log/grafana`, then start the containers again. ``` -ERROR: for Cannot start service : OCI runtime create failed: container_linux.go:349: starting container process caused "process_linux.go:449: container init caused \"rootfs_linux.go:58: mounting ... merged/var/log/grafana: operation not permitted\\\"\"": unknown -ERROR: Encountered errors while bringing up the project. +sudo mkdir /var/log/grafana ``` - -If running Mac OSX the above error might be encountered when starting certain Docker containers that mount `/var/log/`. When first run this causes Docker to try to create the folder `/var/log/grafana` however by default Docker for Mac does not have permission to create folders at this location as it runs as the current user. - -To solve this issue manually create the folder `/var/log/grafana` and give your user write permissions then try starting the containers again.