eulixos/desktop repository overview

⁠The container image of EulixOS with desktop

⁠Usage

• Print out help page:

  docker run eulixos/desktop --help
  

  Copy

• Run command with mapping to local port 5901 (vnc protocol) and 6901 (vnc web access):

  docker run -d -p 5901:5901 -p 6901:6901 eulixos/desktop
  

  Copy

• If you want to get into the container use interactive mode -it and bash

  docker run -it -p 5901:5901 -p 6901:6901 eulixos/desktop bash
  

  Copy

• Build an image from scratch:

  docker build -t desktop .
  

  Copy

⁠Connect & Control

If the container is started like mentioned above, connect via one of these options:

• connect via VNC viewer localhost:5901, default password: vncpassword
• connect via noVNC HTML5 full client: http://localhost:6901/vnc.html⁠, default password: vncpassword
• connect via noVNC HTML5 lite client: http://localhost:6901/?password=vncpassword⁠

⁠Override VNC environment variables

The following VNC environment variables can be overwritten at the docker run phase to customize your desktop environment inside the container:

• VNC_COL_DEPTH, default: 24
• VNC_RESOLUTION, default: 1280x1024
• VNC_PW, default: my-pw

⁠1) Example: Override the VNC password

Simply overwrite the value of the environment variable VNC_PW. For example in the docker run command:

docker run -it -p 5901:5901 -p 6901:6901 -e VNC_PW=my-pw eulixos/desktop

⁠2) Example: Override the VNC resolution

Simply overwrite the value of the environment variable VNC_RESOLUTION. For example in the docker run command:

docker run -it -p 5901:5901 -p 6901:6901 -e VNC_RESOLUTION=800x600 eulixos/desktop

⁠3) Example: View only VNC

Since version 1.2.0 it's possible to prevent unwanted control via VNC. Therefore you can set the environment variable VNC_VIEW_ONLY=true. If set, the startup script will create a random password for the control connection and use the value of VNC_PW for view only connection over the VNC connection.

docker run -it -p 5901:5901 -p 6901:6901 -e VNC_VIEW_ONLY=true eulixos/desktop