# Workshop and SDKcraft 0.9.2 release notes

## 22 June 2026

These release notes cover new features and changes in Workshop and SDKcraft 0.9.2.

## Requirements and compatibility

Workshop relies on Snap and LXD:

- See the [Tutorial](https://ubuntu.com/workshop/docs/tutorial/) for setup instructions.
- Refer to the [Contribution Guide](https://ubuntu.com/workshop/docs/contributing/) for development prerequisites.

## What’s new in 0.9.2

Workshop and SDKcraft 0.9.2 add stricter validation for user-facing YAML files,
friendly host names for workshops, and clearer error guidance, alongside a
device-permission fix and several documentation improvements.

### Workshop

**Repository:** [https://github.com/canonical/workshop](https://github.com/canonical/workshop)

- Added stricter validation for user-facing YAML files: unknown fields are now
  rejected, giving clearer errors for the sketch and project SDKs (community
  contribution).
- Added friendly host names to the `workshop info` output and the default shell
  prompt, through integration with `systemd-resolved`. Host names follow the
  `<WS>.<PROJECT>.wp` pattern:
  ```console
  $ workshop info rocm
  name:      rocm
  base:      ubuntu@22.04
  project:   ~/work/reference-workshops/rocm-samples
  hostname:  rocm.rocm-samples.wp
  ...

  $ workshop shell
  workshop@rocm:/project$
  ```

  Workshops within the same project can reach each other by name,
  e.g. `postgresql.landscape.wp` can use `backend` instead of `backend.landscape.wp`.
  Use `workshop refresh` to activate this feature for existing workshops.
- Improved the error messages shown in `--wait-on-error` situations, offering
  more nuanced, consistent, and actionable guidance.
- Worked around device group ID mismatches between the host and workshop bases by
  adding the `workshop` user to the relevant device groups (such as `render`)
  across the supported bases. This restores access to GPU devices like `/dev/kfd`
  on the `ubuntu@26.04` base. Run `workshop refresh` to apply the change to
  existing workshops.
- Added a definition files reference, guidance on publishing to custom tracks,
  and extended explanations of plugs and slots to the documentation.
- Updated the README to list the reference SDKs, exposed `llms.txt`, and added
  Context7 support.

### SDKcraft

**Repository:** [https://github.com/canonical/sdkcraft](https://github.com/canonical/sdkcraft)

- No changes in this release.

### Reference SDKs

**Repository:** [https://github.com/canonical/reference-sdks](https://github.com/canonical/reference-sdks)

- Populated the `website` property for every reference SDK so it links to the
  SDK’s GitHub page. For example, run `sdk info uv` to see it.

---

**Full Changelog**:

- Workshop: [https://github.com/canonical/workshop/compare/v0.9.1…v0.9.2](https://github.com/canonical/workshop/compare/v0.9.1...v0.9.2)