[ehfd]

• Depends on: feat(selkies-project/selkies): add the Selkies desktop module #1149 (the module this template uses; this branch carries its commits until it merges) and chore(site): add selkies icon coder#30026 (the icon the module's app shows)
• Builds on:
  • feat(selkies-project/selkies): add the Selkies desktop module #1149 (the module)
  • chore(site): add selkies icon coder#30026 (its icon)
  • feat: Run a desktop session behind one port for Jupyter, Coder, and Open OnDemand selkies-project/selkies#409 (the session launcher, now selkies session, and Selkies' own Coder module, addons/coder, which the registry module follows)
  • fix(platforms): Keep OnDemand's tokens in the job, fix Coder's installs, and end what a session daemonizes selkies-project/selkies#421 (the fixes to that addon that the module carries too)

Description

Adds registry/selkies-project/templates/docker-desktop, a Docker workspace on Selkies' desktop image (ghcr.io/selkies-project/selkies/desktop:latest-ubuntu26.04: LXQt, Firefox, and Chrome, with Selkies and Xvfb installed), with a persistent home on /home/ubuntu, 2 GB of shared memory for the desktop's browsers, and the Selkies module with install_selkies = false, which starts the image's default desktop behind Coder's proxy. It follows the shape of the Docker Containers template: the docker_socket variable, the host.docker.internal rewrite, and the labeled home volume.

• GPU: none or NVIDIA. NVIDIA passes the GPUs in with the nvidia runtime, as Selkies' Getting Started does, and NVENC then encodes the stream. None sets NVIDIA_VISIBLE_DEVICES=void, since the image asks for every NVIDIA GPU and a host whose default runtime is NVIDIA's would otherwise pass them in regardless.
• Display backend: X11 or Wayland.
• Intel and AMD need the Docker host's render-node group ID, which a template cannot know, so the README names the two attributes to add rather than offering an option that fails where that ID differs from the image's.

This branch is stacked on #1149 and carries its commit (the namespace, the module, and its icon) until that merges; a rebase then leaves only this template's commit. terraform init of the registry.coder.com/selkies-project/selkies/coder source passes once the module is published; until then scripts/terraform_validate.sh stops at "Module not found".

Type of Change

• New template

Template Information

Path: registry/selkies-project/templates/docker-desktop

Testing & Validation

• Tests pass: templates have no test suite; terraform validate passes with the module source pointed at feat(selkies-project/selkies): add the Selkies desktop module #1149's branch, and go run ./cmd/readmevalidation accepts the README.
• Code formatted (bun fmt): Prettier, terraform fmt, and typos are clean.
• Changes tested locally, in Coder v2.37.5 with Docker on a host with two Tesla P100 GPUs, on the desktop image's Selkies 2.1.0 release, with the module source pointed at feat(selkies-project/selkies): add the Selkies desktop module #1149's branch, opening the Selkies app as a subdomain app in Chrome 155, Firefox 158, and WebKit 27.2:
  • No GPU, X11: no NVIDIA or DRM device in the container, although the host's default runtime is NVIDIA's; LXQt on Xvfb with software H.264; 60 fps in all three browsers.
  • NVIDIA, X11: NVENC H.264 on the P100 with zero-copy capture through the X server's DRI3; 60 fps in all three browsers.
  • NVIDIA, Wayland: NVENC H.264 with zero-copy capture on the render node; 60 fps in all three browsers.
  • No GPU, Wayland, switched on a restart: software H.264; 60 fps in Chrome.
  • The home volume starts with the image's skeleton files and keeps a file across a stop and start.
  • The Intel and AMD attributes in the README, applied through the Docker provider (checked in the earlier run, on Selkies 2.0.0; nothing in it depends on the release): without group_add the render node is refused; with the host's render group ID it opens.
  • WebKit, which presented the NVENC streams unevenly in the earlier run on Selkies 2.0.0, held 60 fps on them with 2.1.0.

Related Issues

#1149, coder/coder#30026, selkies-project/selkies#64

[Copilot]

Copilot was unable to review this pull request because the user who requested the review has reached their quota limit.

[ehfd]

@DevelopmentCats Ready for review again.