strands/strands-docker repository overview

⁠STRANDS distro docker image(s)

Do run an interactive session in the fully installed STRANDS base system, simply make sure you have docker installed on your machine⁠, and then you can simply run

docker run -it --rm strands/strands-docker:kinetic /bin/bash

to launch an interactive session. In there, most STRANDS packages are available, however, access to any local hardware (GPU) is not directly possible, there is more documentation for this at http://wiki.ros.org/docker/Tutorials/Hardware%20Acceleration⁠

But this is enough to have a play with some STRANDS software and connect it to other ROS components as required.

⁠Running on a Linux host

If you want to run this with your local user and actually have the docker container access your X server, run something like:

docker run -it --rm \
    --user=`id -u` \
    --env="DISPLAY" \
    --workdir="/home/$USER" \
    --volume="/home/$USER:/home/$USER" \
    --volume="/etc/group:/etc/group:ro" \
    --volume="/etc/passwd:/etc/passwd:ro" \
    --volume="/etc/shadow:/etc/shadow:ro" \
    --volume="/etc/sudoers.d:/etc/sudoers.d:ro" \
    --volume="/tmp/.X11-unix:/tmp/.X11-unix:rw" \
    strands/strands-docker:kinetic /bin/bash

⁠Running on OSX/Windows

This is a useful guide for running X-enabled docker images on OSX: https://blog.bennycornelissen.nl/bwc-gui-apps-in-docker-on-osx/⁠

and here is a gist run this on a MAC: https://gist.github.com/marc-hanheide/d9b4bb6057665acf7524c7b79827f1c8⁠

Requirements:

• install docker on OSX: https://docs.docker.com/docker-for-mac/⁠
• create a docker machine: docker-machine create --driver virtualbox --virtualbox-memory 2048 docker-vm
• source docker-x.sh from https://gist.github.com/marc-hanheide/d9b4bb6057665acf7524c7b79827f1c8⁠
• run docker_run -it strands/strands-docker:kinetic

⁠Builds

⁠Building locally

build locally via docker build --tag strands/strands-docker:kinetic --network host .

⁠Automated builds on hub.docker.com

This repository is set up to release automatically a STRANDS docker image into the official docker repository at https://hub.docker.com/r/strands/strands-docker/⁠