Hugo Dutka 6940774628
feat: add the portabledesktop module (#805)
## Description
Add a module to install https://github.com/coder/portabledesktop in a
workspace. This will be required for the virtual desktop feature in
Coder Agents.
## Type of Change
- [x] New module
- [ ] New template
- [ ] Bug fix
- [ ] Feature/enhancement
- [ ] Documentation
- [ ] Other
## Module Information
**Path:** `registry/coder/modules/portabledesktop`
**New version:** `v1.0.0`
**Breaking change:** [ ] Yes [x] No
## Testing & Validation
- [x] Tests pass (`bun test`)
- [x] Code formatted (`bun fmt`)
- [x] Changes tested locally
## Related Issues
None
2026-03-17 10:07:35 +01:00

1.3 KiB

display_name description icon verified tags
Portable Desktop Install the portabledesktop binary for lightweight Linux desktop sessions. ../../../../.icons/desktop.svg true
desktop
vnc
ai

Portable Desktop

Install portabledesktop for lightweight Linux desktop sessions over VNC. The binary is stored in the agent's script data directory and is automatically available on PATH via CODER_SCRIPT_BIN_DIR.

module "portabledesktop" {
  source   = "registry.coder.com/coder/portabledesktop/coder"
  version  = "0.1.0"
  agent_id = coder_agent.example.id
}

Examples

Custom download URL with checksum verification

module "portabledesktop" {
  source   = "registry.coder.com/coder/portabledesktop/coder"
  version  = "0.1.0"
  agent_id = coder_agent.example.id
  url      = "https://example.com/portabledesktop-linux-x64"
  sha256   = "e3b0c44298fc1c149afbf4c8996fb92427ae41e4649b934ca495991b7852b855"
}

Additionally copy to a system path

Use install_dir to copy the binary to a system-wide directory in addition to the default script data directory:

module "portabledesktop" {
  source      = "registry.coder.com/coder/portabledesktop/coder"
  version     = "0.1.0"
  agent_id    = coder_agent.example.id
  install_dir = "/usr/local/bin"
}