# Colima v0.9.0 - Product: Colima (https://whatsnew.fyi/product/colima) - Vendor: Abiola Ibrahim - Date: 2025-09-24 - Version: v0.9.0 - Original notes: https://github.com/abiosoft/colima/releases/tag/v0.9.0 - Permalink: https://whatsnew.fyi/product/colima/releases/v0.9.0 - 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'. --- - **added** — Add --network-mode flag to support bridged and shared networking modes, with shared as the default - **added** — Add persistent disk feature for container data that survives instance deletion for Docker, Containerd, and Incus runtimes - **added** — Add --data flag to colima delete command to delete both instance and container data - **added** — Add --port-forwarder flag to make port forwarder configurable between ssh and grpc, defaulting to ssh - **added** — Add --network-preferred-route flag to use the network address interface as the default route when network address is enabled - **fixed** — Reinstate previous template loading behavior where Colima loads config from template file if present, with ability to disable via --template=false - **fixed** — Improve DNS resolution for host.docker.internal to work correctly in Docker, Containerd, and Kubernetes containers - **fixed** — Fix 386 architecture emulation when Rosetta is enabled - **fixed** — Sync default storage pool size for Incus runtime on startup to align with available disk space on the virtual machine - **removed** — Remove /tmp/colima as a default mount due to issues when Colima is run by multiple users on macOS - **changed** — Update Docker version to v28.4.0 - **changed** — Update Nerdctl version to v2.1.4 - **changed** — Update Incus version to v6.16 - **changed** — Update K3s version default to v1.33.4+k3s1 ##### Highlights This is a new release with several fixes and new features. ##### New Features ###### Bridged network This has been a long requested feature and it is finally here. A new `--network-mode` flag has been introduced. Valid options are `shared` and `bridged` with the default being `shared`. ``` colima start --network-address --network-mode bridged ``` ⚠️ Bridged should only be used if required and the local network is compatible. Shared networking is still the recommended option and remains the default. ###### Persistent Disk **This applies only to newly created instances.** Colima now uses a separate virtual machine disk for container data as a means to guard against accidental loss of data. A deleted instance would not delete the container data disk, and a subsequent `colima start` would attempt to reinstate the data. Supported for Docker, Containerd and Incus runtimes. Kubernetes however is not yet support. To delete all data, the `--data` flag should be passed to `colima delete`. ```sh colima delete --data # delete instance and container data ``` ⚠️ While it works reliably, there are no guarantees against loss of data. It should be used as a disaster recovery mechanism. ##### Fixes * The previous behaviour with templates has been reinstated. i.e. Colima would load config from template file if present. It can still be disabled by passing `--template=false` to `colima start`. * DNS resolution for `host.docker.internal` has been improved and now works fine in Docker, Containerd and Kubernetes containers. * `/tmp/colima` has been removed as a default mount due to issues caused when Colima is being run by multiple users on macOS. * Port forwarder is now configurable between `ssh` and `grpc` with the `--port-forwarder` flag. Defaults to `ssh`. * Fix for 386 architecture emulation when Rosetta is enabled. * Introduction of `--network-preferred-route` flag to use the network address interface as the default route when network address is enabled. This resolves networking issue for some users. * The size of the default storage pool for Incus runtime is now synced on startup to align with the available disk space on the virtual machine. ###### Runtime version bumps **NOTE:** container runtime versions can be updated manually by running the `colima update` command. - Docker version updated to `v28.4.0` - Nerdctl version updated to `v2.1.4` - Incus version updated to `v6.16` - K3s version defaults to `v1.33.4+k3s1 ` ##### Commits * k3s: retry ip address retrieval during setup by @Nevon in https://github.com/abiosoft/colima/pull/1374 * build(deps): bump actions/download-artifact from 4.3.0 to 5.0.0 by @dependabot[bot] in https://github.com/abiosoft/colima/pull/1377 * build(deps): bump actions/checkout from 4.2.2 to 5.0.0 by @dependabot[bot] in https://github.com/abiosoft/colima/pull/1378 * chore: replace net.ParseIP("0.0.0.0") with net.IPv4zero by @alexandear in https://github.com/abiosoft/colima/pull/1375 * chore: remove tmp mount by @abiosoft in https://github.com/abiosoft/colima/pull/1379 * cli: default template flag to true. by @abiosoft in https://github.com/abiosoft/colima/pull/1380 * net: use internal dnsmasq by @abiosoft in https://github.com/abiosoft/colima/pull/1381 * net: add support for bridged mode by @abiosoft in https://github.com/abiosoft/colima/pull/1382 * misc: improve password prompt message for network setup by @abiosoft in https://github.com/abiosoft/colima/pull/1383 * vm: make port forwarder configurable by @abiosoft in https://github.com/abiosoft/colima/pull/1384 * chore: fix default value for portForwarder by @abiosoft in https://github.com/abiosoft/colima/pull/1385 * core: update disk images by @abiosoft in https://github.com/abiosoft/colima/pull/1387 * chore: update start command k3s-args example by @jessegonzalez in https://github.com/abiosoft/colima/pull/1386 * vm: enable 386 emulation regardless of roset _[Truncated at 4000 characters — full notes: https://github.com/abiosoft/colima/releases/tag/v0.9.0]_