cryptozero/semux-gui-docker repository overview

⁠semux-gui-docker

Docker image to provide HTML5 VNC interface to access Ubuntu 16.04 LXDE desktop environment with semux gui client

⁠Quick Start

Run the docker image and open port 6080 without password (!!!)

docker run -it --rm -p 6080:80 cryptozero/semux-gui-docker

Browse http://127.0.0.1:6080/⁠

⁠Connect with VNC Viewer and protect by VNC Password

Forward VNC service port 5900 to host by

docker run -it --rm -p 6080:80 -p 5900:5900 cryptozero/semux-gui-docker

Now, open the vnc viewer and connect to port 5900. If you would like to protect vnc service by password, set environment variable VNC_PASSWORD, for example

docker run -it --rm -p 6080:80 -p 5900:5900 -e VNC_PASSWORD=mypassword cryptozero/semux-gui-docker

A prompt will ask password either in the browser or vnc viewer.

⁠Save database and use existing wallet with HTML5 client only

Mount database as volume

docker run -it --rm -p 6080:80 --mount source=semux-database,target=/semux/database -e VNC_PASSWORD=mypassword cryptozero/semux-gui-docker

Database as volume and mount local wallet file into container

docker run -it --rm -p 6080:80 --mount source=semux-database,target=/semux/database -v path_to_wallet:/semux/wallet.data -e VNC_PASSWORD=mypassword cryptozero/semux-gui-docker

⁠Troubleshooting and FAQ

1. boot2docker connection issue, https://github.com/cryptozero/semux-gui-docker/issues/2⁠
2. Screen resolution is fitted to browser's window size when first connecting to the desktop. If you would like to change resolution, you have to re-create the container

⁠License

See the LICENSE file for details.