diff --git a/docker/README.md b/docker/README.md
index 5e76b15..5998307 100644
--- a/docker/README.md
+++ b/docker/README.md
@@ -4,22 +4,20 @@
a non-privileged user able to run the `docker` command, which is usually achieved
by adding the user to the `docker` group.*
-It's a four-steps process with variations depending on the platform.
+It's a three-steps process with variations depending on the platform.
+On the first execution of one of the following docker commands, the
+official container image will be pulled from dockerhub and stored
+locally.
+
+The image includes the required dependencies and the pre-built
+toolchain. As long as you rely on this particular dependencies and
+toolchain versions, you don't need to update the container.
### Get the sources
```
git clone https://github.com/redox-os/redox.git ; cd redox
```
-### Build the container
-This will prepare a docker image with the required dependencies and
-the pre-built toolchain. As long as you rely on this particular
-dependencies and toolchain versions, you don't need to rebuild the
-container.
-```shell
-docker build -t redox docker/
-```
-
### Upate the source tree
Note: if you use the container on a different host or
with a different user, [get the sources first](#get_the_sources).
@@ -34,9 +32,9 @@ docker run --cap-add MKNOD --cap-add SYS_ADMIN --device /dev/fuse \
-e LOCAL_UID="$(id -u)" -e LOCAL_GID="$(id -g)" \
-v redox-"$(id -u)-$(id -g)"-cargo:/usr/local/cargo \
-v redox-"$(id -u)-$(id -g)"-rustup:/usr/local/rustup \
- -v "$(pwd):$(pwd)" -w "$(pwd)" --rm redox make fetch all
+ -v "$(pwd):$(pwd)" -w "$(pwd)" --rm redoxos/redox make fetch all
```
-#### Linux with security modules
+#### Linux with security modules
Add the following options depending on the security modules activated on your system:
```shell
--security-opt label=disable // disable SELinux
@@ -50,7 +48,7 @@ docker run --cap-add MKNOD --cap-add SYS_ADMIN --device /dev/fuse \
--security-opt label=disable \
-v redox-"$(id -u)-$(id -g)"-cargo:/usr/local/cargo \
-v redox-"$(id -u)-$(id -g)"-rustup:/usr/local/rustup \
- -v "$(pwd):$(pwd)" -w "$(pwd)" --rm redox make fetch all
+ -v "$(pwd):$(pwd)" -w "$(pwd)" --rm redoxos/redox make fetch all
```
### Run the container interactively
```shell
@@ -58,14 +56,21 @@ docker run --cap-add MKNOD --cap-add SYS_ADMIN --device /dev/fuse \
-e LOCAL_UID="$(id -u)" -e LOCAL_GID="$(id -g)" \
-v redox-"$(id -u)-$(id -g)"-cargo:/usr/local/cargo \
-v redox-"$(id -u)-$(id -g)"-rustup:/usr/local/rustup \
- -v "$(pwd):$(pwd)" -w "$(pwd)" --rm -it redox
+ -v "$(pwd):$(pwd)" -w "$(pwd)" --rm -it redoxos/redox
```
#### Demo

-### Clear the named volume containing the cargo cache
+### Clear the named volumes containing the toolchain caches
```shell
docker volume rm redox-"$(id -u)-$(id -g)"-cargo \
redox-"$(id -u)-$(id -g)"-rustup
```
+
+### Build the container manually
+If you cannot access dockerhub for whatever reason, you can also build
+the container image manually.
+```shell
+docker build -t redoxos/redox docker/
+```
diff --git a/docker/interactive_demo.gif b/docker/interactive_demo.gif
index 3d31594..0dda088 100644
Binary files a/docker/interactive_demo.gif and b/docker/interactive_demo.gif differ