debian-vnc-xfce-g3/docker/xfce/README-dockerhub.md

Headless Debian/Xfce container with VNC/noVNC

accetto/debian-vnc-xfce-g3

User Guide - GitHub - Dockerfile - Readme - Changelog

---

This Docker Hub repository contains Docker images for headless working.

The images are based on the current Debian 12 and the previous Debian 11 and include Xfce desktop, TigerVNC server and noVNC client.

This User guide describes the images and how to use them.

The related GitHub project contains image generators that image users generally don’t need, unless they want to build the images themselves.

Tags

The following image tags are regularly built and published on Docker Hub:

• latest (also as 12) based on Debian 12

  ![badge_latest_created][badge_latest_created] [![badge_latest_version-sticker][badge_latest_version-sticker]][link_latest_version-sticker-verbose]

• 11 based on Debian 11

  ![badge_11_created][badge_11_created] [![badge_11_version-sticker][badge_11_version-sticker]][link_11_version-sticker-verbose]

Hint: Clicking the version sticker badge reveals more information about the particular build.

Features

The main features and components of the images in the default configuration are:

• lightweight Xfce desktop environment (Debian distribution)
• sudo support
• current version of JSON processor jq
• current version of high-performance TigerVNC server and client
• current version of noVNC HTML5 clients (full and lite) (TCP port 6901)
• popular text editor nano (Debian distribution)
• lite but advanced graphical editor mousepad (Debian distribution)
• current version of tini as the entry-point initial process (PID 1)
• support for overriding environment variables, VNC parameters, user and group (see User guide)
• support of version sticker (see User guide)

The following TCP ports are exposed by default:

• 5901 for access over VNC (using VNC viewer)
• 6901 for access over noVNC (using web browser)

Remarks

There is also a similar sibling repository accetto/ubuntu-vnc-xfce-g3, containing images based on Ubuntu 22.04 LTS and 20.04 LTS.

This is the third generation (G3) of my headless images. The second generation (G2) contains the GitHub repository accetto/xubuntu-vnc-novnc. The first generation (G1) contains the GitHub repository accetto/ubuntu-vnc-xfce.

Getting help

If you've found a problem or you just have a question, please check the User guide, Issues and sibling Wiki first. Please do not overlook the closed issues.

If you do not find a solution, you can file a new issue. The better you describe the problem, the bigger the chance it'll be solved soon.

If you have a question or an idea and you don't want to open an issue, you can also use the sibling Discussions.

---