# Colima v0.8.2

- Product: Colima (https://whatsnew.fyi/product/colima)
- Vendor: Abiola Ibrahim
- Date: 2025-07-31
- Version: v0.8.2
- Original notes: https://github.com/abiosoft/colima/releases/tag/v0.8.2
- Permalink: https://whatsnew.fyi/product/colima/releases/v0.8.2
- Labels: Platforms: macOS, Linux

What's New is an index, not a publisher: every entry below links to the vendor's own release notes, which are the authoritative source. Entries are labelled where they are hand-curated sample data, pre-releases, or drawn from a secondary source such as a developer blog.

Reuse: the summaries, labels and curation here are © What's New. Quote freely with attribution and a link back; wholesale republication of the corpus is not permitted — terms: https://whatsnew.fyi/terms. The vendors' own release notes remain their publishers'.

---

- **fixed** — Report errors that occur while reading configuration file
- **fixed** — Use native shasum binary for download assets verification
- **fixed** — Fix download errors when K3s version is empty in config
- **fixed** — Reset formatting after question prompts in the terminal
- **added** — UDP port forwarding is now supported
- **added** — Binfmt emulation is configurable via the --binfmt flag and binfmt config
- **deprecated** — Rename --cpu flag to --cpus for colima start; --cpu still works but is deprecated
- **added** — Current profile can now be set with COLIMA_PROFILE environment variable
- **changed** — Docker version updated to v28.3.3
- **changed** — Nerdctl version updated to v2.1.3
- **changed** — Incus version updated to v6.14
- **changed** — K3s version defaults to v1.33.3+k3s1

##### Highlights

This is an incremental release with bug fixes.

##### Fixes

* Report errors that occur while reading configuration file. Fixes #1239.
* Use native shasum binary for download assets verification. Fixes #1163.
* Fix download errors when K3s version when empty in config.
* Reset formatting after questions prompts in the terminal. Fixes #1319.

##### Other Updates
* UDP port forwarding is now supported. Resolves #1292, #1300.
* Binfmt emulation is configurable via the `--binfmt` flag and `binfmt` config. Defaults to `true` when Rosetta is disabled.
* Rename `--cpu` flag to `--cpus` for `colima start`, to align with Lima. `--cpu` still works but deprecated.
* Current profile can now be set with `COLIMA_PROFILE` environment variable. Resolves #1308.

###### Runtime version bumps

**NOTE:** container runtime versions can be updated manually by running the `colima update` command.

- Docker version updated to `v28.3.3`
- Nerdctl version updated to `v2.1.3`
- Incus version updated to `v6.14`
- K3s version defaults to `v1.33.3+k3s1 `

##### Commits
* ci: enable gocritic in golangci by @PascalBourdier in https://github.com/abiosoft/colima/pull/1223
* faq: update to address potential need for Docker client configuration by @carljmosca in https://github.com/abiosoft/colima/pull/1231
* cli: add quotes to k3s-arg example for colima start by @olamilekan000 in https://github.com/abiosoft/colima/pull/1230
* chore: update LICENSE, fix copyright license year by @JasonnnW3000 in https://github.com/abiosoft/colima/pull/1235
* chore: fix copyright license year (Revert #1235) by @windyakin in https://github.com/abiosoft/colima/pull/1237
* chore: log possible error while reading config file by @olamilekan000 in https://github.com/abiosoft/colima/pull/1240
* build(deps): bump golang.org/x/term from 0.27.0 to 0.28.0 by @dependabot[bot] in https://github.com/abiosoft/colima/pull/1242
* core: use native shasum binary on macOS for download verification by @abiosoft in https://github.com/abiosoft/colima/pull/1245
* core: config initial value for kubernetes version if empty in yaml by @jason19970210 in https://github.com/abiosoft/colima/pull/1255
* k8s: update latest version for default kubernetes release by @jason19970210 in https://github.com/abiosoft/colima/pull/1259
* core: respect LIMA_SSH_PORT_FORWARDER env var by @abiosoft in https://github.com/abiosoft/colima/pull/1263
* build(deps): bump golang.org/x/term from 0.28.0 to 0.29.0 by @dependabot[bot] in https://github.com/abiosoft/colima/pull/1268
* incus: remove core.https_address from default config by @abiosoft in https://github.com/abiosoft/colima/pull/1273
* build(deps): bump github.com/spf13/cobra from 1.8.1 to 1.9.1 by @dependabot[bot] in https://github.com/abiosoft/colima/pull/1274
* docker: fix cgroupdriver by @win-t in https://github.com/abiosoft/colima/pull/1312
* revert: "docker: fix cgroupdriver" by @abiosoft in https://github.com/abiosoft/colima/pull/1314
* Properly reset formatting at the end of question prompts by @SukritBhatt in https://github.com/abiosoft/colima/pull/1324
* chore: reorganize dependencies in go.mod by @alexandear in https://github.com/abiosoft/colima/pull/1325
* github workflows: pin dependencies by @thypon in https://github.com/abiosoft/colima/pull/1326
* vm: support UDP port forwarding by @stek29 in https://github.com/abiosoft/colima/pull/1343
* core: update disk images by @abiosoft in https://github.com/abiosoft/colima/pull/1351
* k3s: fix config defaults for Kubernetes values by @kaisq in https://github.com/abiosoft/colima/pull/1322
* vm: make binfmt emulation configurable by @winterqt in https://github.com/abiosoft/colima/pull/1315
* docker: replace also localhost with host gateway ip in docker daemon.json by @fralken in https://github.com/abiosoft/colima/pull/1298
* k3s: write kubeconfig to KUBECONFIG defined file by @Sumoa in https://github.com/abiosoft/colima/pull/978
* Multiple minor updates

_[Truncated at 4000 characters — full notes: https://github.com/abiosoft/colima/releases/tag/v0.8.2]_