docker/README.md

[comments]: The original author of Mini-NDN docker is Md Ashiqur Rahman (marahman@email.arizona.edu)

### `docker build`

The Dockerfile can be used directly to `build` an image from scratch.

* Build with `Dockerfile`:
  * Clone the repository and type.
    ```bash
    docker build -t minindn .
    ```
  * You can then access the container through shell with,
    ```bash
    docker run -m 4g --cpus=4 -it --rm --privileged \
           -v /lib/modules:/lib/modules \
           minindn bin/bash
    ```

* Pull from hub:
  * Open a terminal and type:
    ```bash
    docker pull marahman/minindn:v0.2
    ```

  * You can then access the container through shell with,
    ```bash
    docker run -m 4g --cpus=4 -it --rm --privileged -e DISPLAY \
              -v /tmp/.X11-unix:/tmp/.X11-unix \
              -v /lib/modules:/lib/modules \
              marahman/minindn:v0.2 bin/bash
    ```

### Notes:

* Memory (-m), CPU (--cpus) are recommended by Mini-NDN.
* `--privileged` is mandatory for underlying [Mininet](http://mininet.org/) to utilize virtual switch
* Root directory on `run` is `/mini-ndn` containing the installation and examples.
* GUI may not work for now due to docker and xterm setup issues and is independent from Mini-NDN.