shahram7/ubuntu-kde-kasmvnc repository overview

⁠Ubuntu KDE KasmVNC Docker Image

A lightweight alternative to LinuxServer's Webtop — Ubuntu latest + KDE Plasma + KasmVNC, exposed on a single HTTPS port with a self-signed certificate.

⁠🚀 Quick Start

docker run -d \
  --name kde-desktop \
  -p 8443:8443 \
  -e VNC_PASSWORD=changeme \
  --shm-size=1g \
  --restart unless-stopped \
  your-dockerhub-username/ubuntu-kde-kasmvnc:latest

Then open your browser: https://localhost:8443⁠

⁠🐳 Docker Compose

services:
  kde-desktop:
    image: shahram7/ubuntu-kde-kasmvnc:latest
    container_name: kde-desktop
    ports:
      - "8443:8443"
    environment:
      - VNC_PASSWORD=changeme
    shm_size: '1gb'
    restart: unless-stopped

⁠⚙️ Environment Variables

⁠🔐 Ports

⁠🔧 GitHub Actions Setup

Add these secrets to your repository (Settings → Secrets → Actions):

GITHUB_TOKEN is provided automatically by GitHub Actions.

⁠Build Triggers

The image rebuilds automatically when:

• You push to main/master
• Ubuntu base image gets a new digest
• KasmVNC releases a new version
• KDE Plasma gets a package update in Ubuntu
• You trigger it manually via workflow_dispatch

⁠📦 What's Included

• Base: ubuntu:latest
• Desktop: KDE Plasma (full)
• VNC Server: KasmVNC (latest release)
• Apps: Konsole, Dolphin, Kate, Ark, Gwenview, Okular
• SSL: Self-signed 10-year RSA-4096 certificate