osrg/ryu-book repository overview

Ryu-Book Dockerfile

This Dockerfile provides the Docker image for Ryu-Book⁠ published to the public Docker Registry⁠.

Installation

1. Install Docker⁠.

2. Download from public Docker Registry:

   $ docker pull osrg/ryu-book

Usage

1. Before running containers, please enable "root" user to open X11 applications for Mininet⁠:

   $ sudo xhost +si:localuser:root

2. Run Ryu-Book container.

   • With docker run command:

     $ docker run -it --privileged -e DISPLAY=$DISPLAY \
                   -v /tmp/.X11-unix:/tmp/.X11-unix \
                   -v /lib/modules:/lib/modules \
                   osrg/ryu-book
     

     Copy

   • If you have installed Docker Compose⁠, you can run Ryu-Book container with:

     $ wget https://github.com/osrg/ryu-book/raw/master/docker/docker-compose.yml
     
     $ docker-compose run --rm ryu-book
     

     Copy

Running containers via SSH

If your Docker host is on SSH server and you are accessing via SSH, some X11 applications may not be able to open display though X11 forwarding tunnels. In this case, please try the following docker run option to open xterm or other X11 applications on containers.

$ docker run -it --privileged -e DISPLAY=$DISPLAY \
                  -v $HOME/.Xauthority:/root/.Xauthority \
                  -v /lib/modules:/lib/modules \
                  --network host \
                  osrg/ryu-book