Ecosyste.ms: Awesome
An open API service indexing awesome lists of open source software.
https://github.com/JAremko/docker-x11-bridge
Simple Xpra X11 bridge to enable GUI with any docker image
https://github.com/JAremko/docker-x11-bridge
docker docker-image dockerfile gui ssh tcp x11 xpra
Last synced: about 1 month ago
JSON representation
Simple Xpra X11 bridge to enable GUI with any docker image
- Host: GitHub
- URL: https://github.com/JAremko/docker-x11-bridge
- Owner: JAremko
- License: gpl-3.0
- Archived: true
- Created: 2016-11-18T06:27:00.000Z (almost 8 years ago)
- Default Branch: master
- Last Pushed: 2023-10-16T09:49:21.000Z (11 months ago)
- Last Synced: 2024-07-10T07:51:52.882Z (2 months ago)
- Topics: docker, docker-image, dockerfile, gui, ssh, tcp, x11, xpra
- Language: Shell
- Homepage:
- Size: 1.12 MB
- Stars: 175
- Watchers: 12
- Forks: 39
- Open Issues: 8
-
Metadata Files:
- Readme: README.md
- License: LICENSE
Awesome Lists containing this project
README
## Pluggable X11 GUI for docker images
*Run GUI applications in Docker with the same client([Xpra](https://xpra.org/)) on Windows, GNU/Linux, MacOS or web-browser over ssh or tcp.*
**(clickable!)**
[](https://github.com/JAremko/docker-x11-bridge/raw/master/img/demoHD.jpg)
### Try It!
``` bash
docker run -d \
--name x11-bridge \
-e MODE="tcp" \
-e XPRA_HTML="yes" \
-e DISPLAY=:14 \
-e XPRA_PASSWORD=111 \
--net=host \
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&password=111`
See `http://localhost:10000/connect.html` for options
### Or via ssh:
``` bash
docker run -d \
--name x11-bridge \
-e MODE="ssh" \
-v ~/.ssh/pub_rsa:/etc/pub-keys/me.pub \
-e DISPLAY=:14 \
--net=host \
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/.pub`
- If Xpra lags, select `Lowest Bandwidth` when using Xpra app with a local Xpra host.
- With Windows client you'll need [`Pageant`](http://www.chiark.greenend.org.uk/~sgtatham/putty/download.html) you can convert your rsa keys to `Pageant`'s format with [`PuTTYgen`](http://www.chiark.greenend.org.uk/~sgtatham/putty/download.html)
- GUI app in your image may require`libGL.so.1` (provided by libgl1-mesa-glx on Ubuntu) and font
- It is good idea to use [ssl proxy](https://github.com/JrCs/docker-letsencrypt-nginx-proxy-companion) 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](https://github.com/JAremko/docker-x11-bridge/blob/master/Dockerfile#L172)
- 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*