Skip to content

๐Ÿ–ฅ๏ธ ๐ŸŒ x11 webgui baseline for different x11 applications on debian

Notifications You must be signed in to change notification settings

DesktopContainers/webgui-base

Folders and files

NameName
Last commit message
Last commit date

Latest commit

ย 

History

3 Commits
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 

Repository files navigation

Base Image for Desktop Applications on lightweight IceWM Window Manager (x86 + arm)

This container is an alterantive to the desktopcontainers debian-base and alpine-base containers.

It has a different view on things. First of all, it just exposes NoVNC via HTTP on port 8080. It's not meant to be used as a baseimage, but rather as a baseline. So fork this repo, add/install the software and put it's execution script into the /container/scripts/app file.

Since it's not longer using that many services (e.g.: ssh, vnc, https etc.) it has a much smaller footprint and should be easy to maintain and upgrade without the dependency hell of using base images etc.

Only 4 optional environment variables for all configuartion options.

  • HTTP VNC (port: 8080, no password)

Changelogs

  • 2024-01-04
    • complete rewrite of base-debian
    • removed vnc, https, ssh and x11 protocols
    • keep it simple, just a desktop env accessible from a browser

Environment variables and defaults

General

  • ENABLE_SUDO

    • set this to enable to allow the user to use sudo
    • default: not set
  • ENABLE_KIOSK

    • set this to enable to enable Kiosk mode
      • only run app and make sure it will always restart
      • it is advised to not combine with ENABLE_SUDO - but it's still possible to use with sudo enabled.
    • default: not set
    • perfect for (fullscreen) software like rdesktop, vncviewer, Browser etc.

VNC Settings

  • VNC_SCREEN_DEPTH

    • set the screen depth for the xfvb x-server
    • default: 24
    • other possible values:
      • 8
      • 16
      • 24
  • VNC_SCREEN_RESOLUTION

    • set this to a specific resolution like '1280x1024' if you want a specific default one
    • default: 1280x1024
    • depth is configured with VNC_SCREEN_DEPTH env
    • other possible values:
      • 640x480
      • 800x600
      • 1024x768
      • 1280x1024
      • 1280x720
      • 1280x800
      • 1280x960
      • 1360x768
      • 1400x1050
      • 1600x1200
      • 1680x1050
      • 1900x1200
      • 1920x1080
      • 1920x1200

Your custom Application

add all your code used for starting your application/s to /container/scripts/app.

About

๐Ÿ–ฅ๏ธ ๐ŸŒ x11 webgui baseline for different x11 applications on debian

Resources

Stars

Watchers

Forks

Releases

No releases published

Packages