Skip to content

Latest commit

 

History

History
58 lines (35 loc) · 2.52 KB

README.md

File metadata and controls

58 lines (35 loc) · 2.52 KB
Raw

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:

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/