Skip to content

LSIO Webtop

LSIO Webtop

Category: Workstations Type: Workload Template Tags: selkies · vdi · lsio

Overview

LSIO Webtop is a containerized desktop workstation built on LinuxServer.io images, delivered through the browser via Selkies-GStreamer. It provides a full Linux desktop experience accessible from any web browser without VPN or client software. Webtop supports GPU acceleration and is highly configurable — you can launch any LinuxServer.io Webtop image as a workload, from lightweight browser environments to full desktop systems.

How It Works

Workload Template — Installs the LSIO Webtop workload schema into Genesis. Once installed, the Webtop type appears in Genesis on the Workloads page, where it can be authored into a workload template. Users can then launch and provision their own browser-accessible Linux desktop on demand within a project through Hubble.

Prerequisites

  • GPU support requires the NVIDIA GPU Operator plugin installed on the cluster
  • No additional prerequisites for CPU-only Webtop workloads

Installation

  1. Open Terra and navigate to the Plugin Marketplace
  2. Search for "LSIO Webtop"
  3. Click Install
  4. Click Confirm to deploy (no install-time fields required)

Once installed, the LSIO Webtop schema is available in Genesis. From the Workloads page, author the template — users can then launch and provision Webtop desktops on demand through Hubble.

Configuration

Install-Time Fields

No install-time configuration is required for this plugin.

Workload Launch Fields

These fields are configured when authoring the workload template in Genesis and used each time a user provisions a Webtop desktop through Hubble:

Field Details
gpu boolean · Required
Enable GPU passthrough for the workstation
registry string · Required · Default: lscr.io/linuxserver
Container registry for the Webtop image
repo string · Required · Default: chrome
LinuxServer.io image to launch (e.g. chrome, firefox, ubuntu-mate, kde)
tag string · Required · Default: latest
Image tag
publicAccess boolean · Required · Default: false
Disable authentication and allow unauthenticated access

Custom Environment Variables

Genesis lets you add arbitrary environment variables to the workload at launch time. These are commonly useful for a LinuxServer.io Webtop image:

Variable Description
CUSTOM_USER Username for HTTP basic auth in front of the desktop.
PASSWORD Password for HTTP basic auth, used together with CUSTOM_USER.
DOCKER_MODS LinuxServer.io mod(s) to install at container start, e.g. additional apps or tools.
TZ Timezone for the desktop session, e.g. America/New_York.

Notes

  • Browse available LinuxServer.io Webtop images at lscr.io/linuxserver — the repo field maps to the image name (e.g. chrome, ubuntu-kde)
  • Setting publicAccess to true removes authentication from the workstation endpoint — use only in trusted network environments
  • GPU acceleration requires compatible NVIDIA hardware and the NVIDIA GPU Operator plugin
  • Webtop workstations are stateless by default; add volume mounts via Genesis at workload creation time to persist user data
plugins/lsio-webtop/terra.yaml
 1
 2
 3
 4
 5
 6
 7
 8
 9
10
11
resource_id: lsio-webtop
name: LSIO Webtop
icon: https://raw.githubusercontent.com/juno-fx/Terra-Official-Plugins/refs/heads/main/plugins/lsio-webtop/scripts/assets/logo.png
description: Webtop containerized workstation from LinuxServer.io.
category: Workstations
tags:
  - selkies
  - vdi
  - lsio
  - cluster-level
fields: []