|
@@ -4,7 +4,7 @@
|
|
This image is intended to be used for displaying X11 applications from other containers in a browser. A stand-alone demo as well as a [Version 2](https://docs.docker.com/compose/compose-file/#version-2) composition.
|
|
This image is intended to be used for displaying X11 applications from other containers in a browser. A stand-alone demo as well as a [Version 2](https://docs.docker.com/compose/compose-file/#version-2) composition.
|
|
|
|
|
|
## Image Contents
|
|
## Image Contents
|
|
-___
|
|
|
|
|
|
+
|
|
* [Xvfb](http://www.x.org/releases/X11R7.6/doc/man/man1/Xvfb.1.xhtml) - X11 in a virtual framebuffer
|
|
* [Xvfb](http://www.x.org/releases/X11R7.6/doc/man/man1/Xvfb.1.xhtml) - X11 in a virtual framebuffer
|
|
* [x11vnc](http://www.karlrunge.com/x11vnc/) - A VNC server that scrapes the above X11 server
|
|
* [x11vnc](http://www.karlrunge.com/x11vnc/) - A VNC server that scrapes the above X11 server
|
|
* [noNVC](https://kanaka.github.io/noVNC/) - A HTML5 canvas vnc viewer
|
|
* [noNVC](https://kanaka.github.io/noVNC/) - A HTML5 canvas vnc viewer
|
|
@@ -12,20 +12,24 @@ ___
|
|
* [socat](http://www.dest-unreach.org/socat/) - for use with other containers
|
|
* [socat](http://www.dest-unreach.org/socat/) - for use with other containers
|
|
* [xterm](http://invisible-island.net/xterm/) - to demo that it works
|
|
* [xterm](http://invisible-island.net/xterm/) - to demo that it works
|
|
* [supervisord](http://supervisord.org) - to keep it all running
|
|
* [supervisord](http://supervisord.org) - to keep it all running
|
|
|
|
+
|
|
## Usage
|
|
## Usage
|
|
-___
|
|
|
|
|
|
+
|
|
|
|
+### Variables
|
|
|
|
+
|
|
|
|
+You can specify the following variables:
|
|
|
|
+* `DISPLAY_WIDTH=<width>` (1024)
|
|
|
|
+* `DISPLAY_HEIGHT=<height>` (768)
|
|
|
|
+* `RUN_XTERM={yes|no}` (yes)
|
|
|
|
+* `RUN_FLUXBOX={yes|no}` (yes)
|
|
|
|
+
|
|
### Stand-alone Demo
|
|
### Stand-alone Demo
|
|
-*On Windows and OS X Only -*
|
|
|
|
-Determine the Docker machine IP address:
|
|
|
|
-```bash
|
|
|
|
-$ docker-machine ip $(docker-machine active)
|
|
|
|
-192.168.99.101
|
|
|
|
-```
|
|
|
|
Run:
|
|
Run:
|
|
```bash
|
|
```bash
|
|
$ docker run --rm -it -p 8080:8080 theasp/novnc
|
|
$ docker run --rm -it -p 8080:8080 theasp/novnc
|
|
```
|
|
```
|
|
-Open a browser and hit the *Connect* button to see the `xterm` demo at `http://<DOCKER_MACHINE_IP>:8080/vnc.html`
|
|
|
|
|
|
+Open a browser and see the `xterm` demo at `http://<server>:8080/vnc.html`
|
|
|
|
+
|
|
### V2 Composition
|
|
### V2 Composition
|
|
A version of the [V2 docker-compose example](https://github.com/theasp/docker/blob/master/docker-compose.yml) is shown below to illustrate how this image can be used to greatly simplify the use of X11 applications in other containers. With just `docker-compose up -d`, your favorite IDE can be accessed via a browser.
|
|
A version of the [V2 docker-compose example](https://github.com/theasp/docker/blob/master/docker-compose.yml) is shown below to illustrate how this image can be used to greatly simplify the use of X11 applications in other containers. With just `docker-compose up -d`, your favorite IDE can be accessed via a browser.
|
|
|
|
|
|
@@ -61,6 +65,7 @@ networks:
|
|
x11:
|
|
x11:
|
|
```
|
|
```
|
|
**If the IDE fails to start simply run `docker-compose restart <container-name>`.**
|
|
**If the IDE fails to start simply run `docker-compose restart <container-name>`.**
|
|
|
|
+
|
|
## On DockerHub / GitHub
|
|
## On DockerHub / GitHub
|
|
___
|
|
___
|
|
* DockerHub [theasp/novnc](https://hub.docker.com/r/theasp/novnc/)
|
|
* DockerHub [theasp/novnc](https://hub.docker.com/r/theasp/novnc/)
|