Skip to content

kramergroup/vnc-ubuntu

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

13 Commits
 
 
 
 
 
 
 
 
 
 

Repository files navigation

vnc-ubuntu

This container provides a VNC-enabled container based on Ubuntu.

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

  • Openbox minimal Window Manager
  • Graphical login (not configured by default)

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-ubuntu

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

Environment variables

The behaviour of the container can be controlled through a number of environment variables.

Name Default Description
GEOMETRY 1600x900 Display dimensions
RFBPORT 5900 The VNC server port
USERNAME root The default user username (will be created if needed)
USERID auto The UID of the default user

Graphical User login (optional)

A connecting VNC client will be presented with a login window for the first time only. Note that terminating the VNC connection is not sufficient to logout the user! There is no default user configured.

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-ubuntu 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 urxvt with a small number of extensions pre-installed. Awesome urxvt has a curated list of other useful extensions.

About

No description, website, or topics provided.

Resources

Stars

Watchers

Forks

Releases

No releases published

Packages

No packages published