Public | Automated Build

Last pushed: 2 years ago
Short Description
Containerized X11 version of TeamViewer.
Full Description


Dockerfile to create a Docker image of

This container will attempt to mount the host's X11 unix
domain socket in order to create its graphical window on the host's X11 server.


This container can be installed from either the Docker
or by cloning this project to your host and running
make. For most users installing from the hub will be sufficient.

This container is deployed with a wrapper script that makes running the docker
image very simple. Simply chose one of the installation methods below to get

Installing from Docker Hub:

docker run -it --rm \
    -v /usr/local/bin:/target \
    hurricane/teamviewer \

Installing from GitHub:

git clone
cd teamviewer
make instl


You can use this container however your imagination sees fit. The suggested
method though is via the wrapper script that comes bundled with this docker
image. You can start TeamViewer, after installation,
by executing the following command:


You can of course also run this container manually by executing a command like in
the example below:

touch ${XAUTH}
xauth nlist :0 | sed -e 's/^..../ffff/' | xauth -f ${XAUTH} nmerge -
docker run -d -e DISPLAY \
    -v /tmp/.X11-unix:/tmp/.X11-unix \

Technical Information:

This container is developed on top of openSUSE's
base image. This
conscious decision was made to yield the smallest image possible.

The wrapper script, which gets installed by executing any of the suggested
installtion methods, makes running this container simple. The script will ensure
that the appropriate environment variables get passed onto the container.
Additionally, it ensures that the container gets automatically stopped once you
have exited TeamViewer. These environment variables are as follows:

  • TZ - for timezone.
  • APP_UID - UID of the user executing the wrapper script
  • APP_GID - GID of the user executing the wrapper script
  • APP_USER - username of the user executing the wrapper script
  • DISPLAY - X11 display server name
  • XAUTH - authority file providing credentials to access X11 server

Known Issues:

  • system tray icon gets rendered on desktop as a large blue window using i3 wm.
    It is recommended to add the following three lines to you i3 config in order to
    stop the tray icon from being rendered at all.
    for_window [instance="TeamViewer.exe"] floating enable
    for_window [class="TeamViewer"] floating enable
    for_window [instance="Qt-subapplication" title="TeamViewer"] move scratchpad
    Feel free to report additional issues.


  1. Fork it!
  2. Create your feature branch: git checkout -b my-new-feature
  3. Commit your changes: git commit -am 'Add some feature'
  4. Push to the branch: git push origin my-new-feature
  5. Submit a pull request :D


  • 2015-12-18 - TeamViewer 11, initial release.
  • 2016-01-20 - TeamViewer 11, update to new docker templates.


Code released under the MIT license.

Docker Pull Command