Skip to content
Simple Xpra X11 bridge to enable GUI with any docker image
Branch: master
Clone or download
Latest commit 93d8b8c Mar 31, 2019
Permalink
Type Name Latest commit message Commit time
Failed to load latest commit information.
bin stat-argument Mar 21, 2019
img init Nov 18, 2016
video_dummy_patches Use patched dummy (for DPI) && avoid using pip (size) Jul 23, 2018
.dockerignore fix screenshot at DockerHub Nov 18, 2016
Dockerfile up Xpra 2.3.2 => 2.5 Mar 31, 2019
LICENSE
README.md up README Jul 23, 2018
xpra_sha up Xpra 2.3.2 => 2.5 Mar 31, 2019

README.md

Pluggable X11 GUI for docker images

Run GUI applications in Docker with the same client(Xpra) on Windows, GNU/Linux, MacOS or web-browser over ssh or tcp.

(clickable!) img/demo.jpg

Try It!

docker run -d \
 --name x11-bridge \
 -e MODE="tcp" \
 -e XPRA_HTML="yes" \
 -e DISPLAY=:14 \
 -p 10000:10000 \
 jare/x11-bridge

docker run -d \
 --name emacs-1 \
 --volumes-from x11-bridge \
 -e DISPLAY=:14 \
 jare/emacs emacs

docker run -d \
 --name emacs-2 \
 --volumes-from x11-bridge \
 -e DISPLAY=:14 \
 jare/emacs emacs

Then visit http://localhost:10000/index.html?encoding=rgb32 See http://localhost:10000/connect.html for options

Or via ssh:

docker run -d \
 --name x11-bridge \
 -e MODE="ssh" \
 -p 22:22 \
 -v ~/.ssh/pub_rsa:/etc/pub-keys/me.pub \
 -e DISPLAY=:14 \
 jare/x11-bridge

docker run -d \
 --name emacs-1 \
 --volumes-from x11-bridge \
 -e DISPLAY=:14 \
 jare/emacs emacs

docker run -d \
 --name emacs-2 \
 --volumes-from x11-bridge \
 -e DISPLAY=:14 \
 jare/emacs emacs

Then attach to the Xpra server via cmd tool or Xpra's GUI app: xpra attach --encoding=rgb --ssh="ssh -o StrictHostKeyChecking=no -p 22" ssh:xpra@localhost:14

  • Note -o StrictHostKeyChecking=no - it allows us to ignore server's identity instead adding it to known_hosts. If you want to rely on the identity you should use a privately built image.
  • All names of the pub keys should end with .pub i.e. /etc/pub-keys/<key_name>.pub
  • If Xpra lags, select Lowest Bandwidth when using Xpra app with a local Xpra host.
  • With Windows client you'll need Pageant you can convert your rsa keys to Pageant's format with PuTTYgen
  • GUI app in your image may requirelibGL.so.1 (provided by libgl1-mesa-glx on Ubuntu) and font
  • It is good idea to use ssl proxy or mount a certificate (see Xpra start-up message) if you want to use tcp or html mode beyond local network
  • You can modify the user
  • To use Xpra mmap(Linux): docker run ... -v /tmp/spacemacs-mmap/:/tmp/spacemacs-mmap/ ... jare/x11-bridge and attach with TMPDIR=/tmp/spacemacs-mmap/ xpra attach --mmap=yes --encoding=rgb --ssh="ssh -o StrictHostKeyChecking=no -p 22" ssh:xpra@localhost:14

Webcam and sound are currently disabled

You can’t perform that action at this time.