Dev Dock

A GUI Container using Xfce with noVNC.

Only support x86/64.

Also can check the GUI Management.

This repo is creating a common GUI image by using docker for developing.

The image included the following components:

Xfce Desktop
VNC Server (default VNC port: 5901)
VNC Client with HTML5 support (default http port: 6901)
OpenSSH (default SSH port: 22)
Git
Mini Conda
VScode
Firefox
Anydesk

Run docker without sudo

sudo groupadd docker && gpasswd -a $USER docker

＊ You can change $USER to match your preferred user name if you do not want to use your current user

Usage

Quick start

Build an image and run a testing container.

docker-compose build && docker-compose up

NVidia GPU support

If you need use this with NVIDIA GPUs, you need to follow this in the main system.

Installing the NVIDIA Container Toolkit

When NVidia Docker is installed, use this command to run a testing container with GPU support.

docker-compose -f docker-compose.nvidia.yml build && docker-compose -f docker-compose.nvidia.yml up

Connection

If you have not change the default port yet, you can use the services with the following ports.

VNC port: 5901, connect with host <YOUR_HOST_IP> and <PORT>
noVNC port: 6901, connect via http://<YOUR_HOST_IP>:6901/?password=<YOUR_VNC_PASSWORD>
SSH port: 22, connect with command line ssh root@<YOUR_HOST_IP>:<PORT>

＊ You can login SSH with default user or root.

Parameters

You can use these parameters to set some settings.

Map ports
- 5901 (vnc protocol)
- 6901 (vnc web access)
- 22 (ssh protocol)

-p 12345:5901 -p 13579:6901 -p 24680:22

Set the same timezone

-v /etc/localtime:/etc/localtime:ro

Mount a volume

-v <YOUR_LOCAL_PATH>:<>YOUR_CONTAINER_PATH>

Mount a network disk as a volume

sudo mount -t cifs -o username=<YOUR_USER_NAME>,password=<YOUR_PASSWORD>,vers=3.0 //<YOUR_NETWORK_LOCATION> <LOCAL_LOCATION>

-v <LOCAL_LOCATION>:<>YOUR_CONTAINER_PATH>

Override the VNC resolution

-e VNC_RESOLUTION=1920x1080

Change the VNC password

-e VNC_PW=<YOUR_VNC_PWD>

Change root password

-e ROOT_PASSWORD='root'

Add user

-e DEFAULT_USER='user' -e DEFAULT_USER_PASSWORD='user'

Execution with the only docker command

You need to restart the container to make Chinese input method work after first login into VNC.

Run a testing container

docker run -d -p 12345:5901 -p 13579:6901 -p 24680:22 \
            -v /etc/localtime:/etc/localtime:ro \
            -v /home/infor/Desktop/test/:/root/Desktop/ \
            -e VNC_PW=infor1234 \
            -e VNC_RESOLUTION=1600x900 \
            -e DEFAULT_USER='test' -e DEFAULT_USER_PASSWORD='test' \
            -e ROOT_PASSWORD='root' \
            --name test test-vnc-gui

License

MIT

NatLee/dev-dock