From 81559af69f167a13cd42c704ad7ac1378b492794 Mon Sep 17 00:00:00 2001
From: Andre Richter <andre.o.richter@gmail.com>
Date: Fri, 29 Sep 2017 13:49:50 +0200
Subject: [PATCH] docker: Add troubleshooting section

---
 docker/README.md | 9 +++++++++
 1 file changed, 9 insertions(+)

diff --git a/docker/README.md b/docker/README.md
index 5998307..dac057c 100644
--- a/docker/README.md
+++ b/docker/README.md
@@ -74,3 +74,12 @@ the container image manually.
 ```shell
 docker build -t redoxos/redox docker/
 ```
+
+### Troubleshooting / updating
+Sometimes, builds may fail because the nightly toolchain of rust inside the container got out of sync with dependencies of redox, or there are issues with cargo. In this case, it might help to update your current container image and delete the rust and cargo caches. This way, you can start over from a clean state and rule out your local setup as the origin of errors.
+
+```shell
+docker pull redoxos/redox
+docker volume rm redox-"$(id -u)-$(id -g)"-cargo \
+    redox-"$(id -u)-$(id -g)"-rustup
+```