diff --git a/docs/sources/documentation/examples/hello_world.rst b/docs/sources/documentation/examples/hello_world.rst
index 910bc1f366..f6387d487e 100644
--- a/docs/sources/documentation/examples/hello_world.rst
+++ b/docs/sources/documentation/examples/hello_world.rst
@@ -8,19 +8,34 @@ Hello World
===========
This is the most basic example available for using docker
-This example assumes you have Docker installed and it will download the busybox image and then use that image to run a simple echo command, that will echo hello world back to the console over standard out.
+This example assumes you have Docker installed.
+
+
+Download the base container
.. code-block:: bash
- $ docker run busybox /bin/echo hello world
+ # Download a base image
+ docker pull base
+
+The *base* image is a minimal *ubuntu* based container, alternatively you can select *busybox*, a bare
+minimal linux system. The images are retrieved from the docker repository.
+
+
+.. code-block:: bash
+
+ #run a simple echo command, that will echo hello world back to the console over standard out.
+ docker run base /bin/echo hello world
**Explanation:**
- **"docker run"** run a command in a new container
-- **"busybox"** is the image we want to run the command inside of.
+- **"base"** is the image we want to run the command inside of.
- **"/bin/echo"** is the command we want to run in the container
- **"hello world"** is the input for the echo command
+
+
**Video:**
See the example in action
@@ -28,7 +43,8 @@ See the example in action
.. raw:: html
-
+
+
Continue to the :ref:`hello_world_daemon` example.
\ No newline at end of file
diff --git a/docs/sources/documentation/examples/hello_world_daemon.rst b/docs/sources/documentation/examples/hello_world_daemon.rst
index e92a67cde6..6ced505f1d 100644
--- a/docs/sources/documentation/examples/hello_world_daemon.rst
+++ b/docs/sources/documentation/examples/hello_world_daemon.rst
@@ -8,18 +8,20 @@ Hello World Daemon
==================
The most boring daemon ever written.
-This example assumes you have Docker installed and with the busybox image already imported. We will use the busybox image to run a simple hello world daemon that will just print hello world to standard out every second. It will continue to do this until we stop it.
+This example assumes you have Docker installed and with the base image already imported ``docker pull base``.
+We will use the base image to run a simple hello world daemon that will just print hello world to standard
+out every second. It will continue to do this until we stop it.
**Steps:**
.. code-block:: bash
- $ CONTAINER_ID=$(docker run -d busybox /bin/sh -c "while true; do echo hello world; sleep 1; done")
+ $ CONTAINER_ID=$(docker run -d base /bin/sh -c "while true; do echo hello world; sleep 1; done")
We are going to run a simple hello world daemon in a new container made from the busybox daemon.
- **"docker run -d "** run a command in a new container. We pass "-d" so it runs as a daemon.
-- **"busybox"** is the image we want to run the command inside of.
+- **"base"** is the image we want to run the command inside of.
- **"/bin/sh -c"** is the command we want to run in the container
- **"while true; do echo hello world; sleep 1; done"** is the mini script we want to run, that will just print hello world once a second until we stop it.
- **$CONTAINER_ID** the output of the run command will return a container id, we can use in future commands to see what is going on with this process.
@@ -35,7 +37,7 @@ Check the logs make sure it is working correctly.
.. code-block:: bash
- $ docker attach $CONTAINER_ID
+ docker attach $CONTAINER_ID
Attach to the container to see the results in realtime.
@@ -44,7 +46,7 @@ Attach to the container to see the results in realtime.
.. code-block:: bash
- $ docker ps
+ docker ps
Check the process list to make sure it is running.
@@ -61,7 +63,7 @@ Stop the container, since we don't need it anymore.
.. code-block:: bash
- $ docker ps
+ docker ps
Make sure it is really stopped.
@@ -76,4 +78,12 @@ See the example in action
-Continue to the :ref:`python_web_app` example.
\ No newline at end of file
+Continue to the :ref:`python_web_app` example.
+
+
+Notes:
+------
+
+- **Docker daemon** The docker daemon is started by ``sudo docker -d``, Vagrant may have started
+ the Docker daemon for you, but you will need to restart it this way if it was terminated. Otherwise
+ it may give you ``Couldn't create Tag store: open /var/lib/docker/repositories: permission denied``