# Workshop and SDKcraft 0.9.5 release notes

## 17 August 2026

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

## 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.5

Workshop and SDKcraft 0.9.5 preserve manual interface connections across
`workshop refresh`, enable a Workshop-specific OpenSSH client configuration by
default, and support the `desktop` interface in WSL. The release also switches
SDKcraft to Ubuntu One SSO, adds the `sdkcraft logout` command and the
`sdkcraft login --export` option for CI pipelines, and prepares the first public
release of the VS Code Workshop extension.

### Workshop

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

- Manual interface connections are now preserved on `workshop refresh`.
  `workshop restore` resets connections to defaults.
- Support the `desktop` interface in a WSL environment. See the outstanding WSL
  [bug](https://github.com/microsoft/WSL/issues/12436) for details.
- Enable Workshop-specific OpenSSH client config by default on distributions
  that support `/etc/ssh/ssh_config.d/`. Connecting to a workshop host via SSH
  requires no manual configuration. See
  [docs](https://ubuntu.com/workshop/docs/explanation/architecture/components/#network)
  for more info. Your running workshops need to be removed and launched again to
  benefit from the automatic configuration.
- `workshop init --sdks` is now optional and accepts in-project and try SDKs.

### SDKcraft

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

- Switched to Ubuntu One SSO. It requires `sdkcraft logout` and `sdkcraft login`
  to get new credentials.
- Added the `sdkcraft login --export` option to export credentials in a file for
  CI pipelines.
- Added the `sdkcraft logout` command.

### Reference SDKs

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

- `vscode-remote` SDK: will be made obsolete and phased out due to the automatic
  OpenSSH configuration change. The upcoming first release of the VS Code
  extension will take care of the code server caching and preserving
  configuration over refreshes.

### Docs

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

- Updated README to be example-focused and less verbose.
- Expanded documentation on workshop hostnames and automatic SSH configuration.
- Documented the backward compatibility policy for workshops.

### VS Code Workshop extension

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

- Prepared VS Code extension for the first public release. The extension will be
  made available after the Workshop 0.9.5 release.

---

**Full Changelog**:

- Workshop: [https://github.com/canonical/workshop/compare/v0.9.4…v0.9.5](https://github.com/canonical/workshop/compare/v0.9.4...v0.9.5)
- SDKcraft: [https://github.com/canonical/sdkcraft/compare/0.9.2…0.9.5](https://github.com/canonical/sdkcraft/compare/0.9.2...0.9.5)
