vnc-alpine

This container provides a VNC-enabled container based on Alpine Linux.

The container is meant to serve a basis for containerised X11 applications. It has the following features:

• Openbox minimal Window Manager
• Graphical login

Based on Alpine Linux, the container is less than 150 MB in size. Most of this is the X11 window system.

Usage

The container runs a VNC server on port 5900. This port has to be mapped for VNC clients to access it:

docker run -d -p 5900:5900 kramergroup/vnc-alpine

Once the container is running, point a VNC viewer to localhost:5900.

User login

A connecting VNC client will be presented with a login window for the first time only. The default username and password are alpine/alpine. Note that terminating the VNC connection is not sufficient to logout the user!

Adding Users

The usual useradd/passwd feature of linux is available. To add a user to a running container with name vnc-alpine use:

  docker exec -it vnc-alpine adduser <username>

Openbox Window Manager

The container uses the Openbox window manager. Openbox is lightweight and easy to configure (via xml files). Programs are started using a right-click, which produces a menu with options.

Terminal

The container uses a fork of the Suckless terminal, which is based on Luke Smith's adaption of st.