Skip to content

docs: add older macos versions incompatibility instructions#1428

Merged
abiosoft merged 5 commits into
abiosoft:mainfrom
mlbiche:document-old-macos
Oct 8, 2025
Merged

docs: add older macos versions incompatibility instructions#1428
abiosoft merged 5 commits into
abiosoft:mainfrom
mlbiche:document-old-macos

Conversation

@mlbiche
Copy link
Copy Markdown
Contributor

@mlbiche mlbiche commented Oct 7, 2025

@abiosoft
Copy link
Copy Markdown
Owner

abiosoft commented Oct 7, 2025

Thanks for this :)

I think I would prefer for this to be in the FAQ or the Install.md file.

@mlbiche
Copy link
Copy Markdown
Contributor Author

mlbiche commented Oct 7, 2025

Unfortunately, I was not able to finish the installation on macOS 12 Monterey. Qemu is only compatible macOS>=14, so I couldn't install it through Homebrew. I moved to MacPorts, as it let install older versions, but even installing older versions of Qemu that should be compatible with macOS 12 Monterey was not successful. I was always stuck with:

Waiting for the essential requirement 1 of 4: "ssh"

I finally opted for an older version of Docker Desktop as it is the only solution I could make works.

I will update my PR then, and move this to install.md and faq.md as you recommend.

@abiosoft
Copy link
Copy Markdown
Owner

abiosoft commented Oct 7, 2025

Unfortunately, I was not able to finish the installation on macOS 12 Monterey.

Sorry to hear that. Unfortunately macOS is known for poor backward compatibility.

@mlbiche mlbiche changed the title feat: add vm installation instructions for older macos versions docs: add older macos versions incompatibility instructions Oct 8, 2025
@mlbiche
Copy link
Copy Markdown
Contributor Author

mlbiche commented Oct 8, 2025

@abiosoft I have updated the docs to mention macOS version restriction and to indicate some solutions for older versions. I let you check it and give me feedback 🙂

Comment thread README.md Outdated
Comment thread README.md Outdated
Comment thread docs/FAQ.md Outdated
Comment thread docs/FAQ.md Outdated
@abiosoft
Copy link
Copy Markdown
Owner

abiosoft commented Oct 8, 2025

Can you kindly attend to the reviews?

Also you would need to sign your git commits https://github.com/abiosoft/colima/blob/main/docs/CONTRIBUTE.md#3-commit-your-changes.

Thanks.

@mlbiche mlbiche force-pushed the document-old-macos branch from ed8a44a to cf79176 Compare October 8, 2025 14:27
@abiosoft
Copy link
Copy Markdown
Owner

abiosoft commented Oct 8, 2025

Can you sign the certificate of origin? The following command should do the trick to amend your last commit.

git commit --amend -s

mlbiche and others added 5 commits October 8, 2025 17:50
Signed-off-by: mlbiche <tmlb@pm.me>
Co-authored-by: Abiola Ibrahim <git@abiosoft.com>
Signed-off-by: mlbiche <tmlb@pm.me>
Signed-off-by: mlbiche <tmlb@pm.me>
@mlbiche mlbiche force-pushed the document-old-macos branch from 28d9a92 to abcd704 Compare October 8, 2025 15:50
@abiosoft abiosoft merged commit c5e126a into abiosoft:main Oct 8, 2025
1 check passed
@abiosoft
Copy link
Copy Markdown
Owner

abiosoft commented Oct 8, 2025

Thanks :)

tmeijn pushed a commit to tmeijn/dotfiles that referenced this pull request Feb 15, 2026
This MR contains the following updates:

| Package | Update | Change |
|---|---|---|
| [abiosoft/colima](https://github.com/abiosoft/colima) | minor | `v0.9.1` → `v0.10.0` |

MR created with the help of [el-capitano/tools/renovate-bot](https://gitlab.com/el-capitano/tools/renovate-bot).

**Proposed changes to behavior should be submitted there as MRs.**

---

### Release Notes

<details>
<summary>abiosoft/colima (abiosoft/colima)</summary>

### [`v0.10.0`](https://github.com/abiosoft/colima/releases/tag/v0.10.0)

[Compare Source](abiosoft/colima@v0.9.1...v0.10.0)

#### Highlights

This release introduces AI support and other updates.

##### AI is here

Colima now has AI support.

By leveraging [Krunkit](https://github.com/containers/krunkit) and [Ramalama](https://ramalama.ai/), Colima is able to provide the ideal platform to run confined, isolated and secure gpu-powered AI workloads on Apple Silicon devices.

```sh

# run a model
colima model run gemma3

# serve a model, chat interface would be availabe at localhost:8080
colima model serve gemma3

# for more
colima model --help
```

#### Other Updates

- Addition of `krunkit` virtual machine type with gpu support. `colima start --vm-type krunkit`.
- Incus instances are now reachable directly from the host if network address is enabled. `colima start --network-address`.
- Containerd runtime (with nerdctl command) now inherits `CONTAINERD_*` and `NERDCTL_*` environment variables on the host.
- Port forwarding can now be disabled by passing `--port-forwarder=none` to `colima start`.
- Volume mounts can now be disabled by passing `--mount=none` to `colima start`.
- Download mechanism has been reworked in native Go, eliminating dependency on `curl` and `shasum` on the host.
- New `after-boot` and `ready` provision modes for provision scripts.

##### Runtime version bumps

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

- Docker version updated to `v29.2.0`
- Nerdctl version updated to `v2.2.1`
- Incus version updated to `v6.21`
- K3s version defaults to `v1.35.0+k3s1`.

#### Commits

- ci: move to macos-15-intel runner by [@&#8203;abiosoft](https://github.com/abiosoft) in [#&#8203;1425](abiosoft/colima#1425)
- docs: add older macos versions incompatibility instructions by [@&#8203;mlbiche](https://github.com/mlbiche) in [#&#8203;1428](abiosoft/colima#1428)
- build(deps): bump mxschmitt/action-tmate from 3.22 to 3.23 by [@&#8203;dependabot](https://github.com/dependabot)\[bot] in [#&#8203;1439](abiosoft/colima#1439)
- build(deps): bump actions/upload-artifact from 4.6.2 to 5.0.0 by [@&#8203;dependabot](https://github.com/dependabot)\[bot] in [#&#8203;1440](abiosoft/colima#1440)
- build(deps): bump actions/download-artifact from 5.0.0 to 6.0.0 by [@&#8203;dependabot](https://github.com/dependabot)\[bot] in [#&#8203;1441](abiosoft/colima#1441)
- build(deps): bump golangci/golangci-lint-action from 8.0.0 to 9.0.0 by [@&#8203;dependabot](https://github.com/dependabot)\[bot] in [#&#8203;1446](abiosoft/colima#1446)
- docs: specify qemu-full for Arch instructions by [@&#8203;zachcb](https://github.com/zachcb) in [#&#8203;1451](abiosoft/colima#1451)
- docs: add mise as an installation method by [@&#8203;jylenhof](https://github.com/jylenhof) in [#&#8203;1456](abiosoft/colima#1456)
- net: add ability to customize gateway address by [@&#8203;Guilospanck](https://github.com/Guilospanck) in [#&#8203;1447](abiosoft/colima#1447)
- misc: multiple updates by [@&#8203;abiosoft](https://github.com/abiosoft) in [#&#8203;1473](abiosoft/colima#1473)
- build(deps): bump actions/setup-go from 6.0.0 to 6.1.0 by [@&#8203;dependabot](https://github.com/dependabot)\[bot] in [#&#8203;1455](abiosoft/colima#1455)
- build(deps): bump golangci/golangci-lint-action from 9.0.0 to 9.2.0 by [@&#8203;dependabot](https://github.com/dependabot)\[bot] in [#&#8203;1464](abiosoft/colima#1464)
- build(deps): bump actions/checkout from 5.0.0 to 6.0.1 by [@&#8203;dependabot](https://github.com/dependabot)\[bot] in [#&#8203;1465](abiosoft/colima#1465)
- build(deps): bump actions/upload-artifact from 5.0.0 to 6.0.0 by [@&#8203;dependabot](https://github.com/dependabot)\[bot] in [#&#8203;1466](abiosoft/colima#1466)
- build(deps): bump actions/download-artifact from 6.0.0 to 7.0.0 by [@&#8203;dependabot](https://github.com/dependabot)\[bot] in [#&#8203;1467](abiosoft/colima#1467)
- build(deps): bump actions/setup-go from 6.1.0 to 6.2.0 by [@&#8203;dependabot](https://github.com/dependabot)\[bot] in [#&#8203;1479](abiosoft/colima#1479)
- build(deps): bump actions/checkout from 6.0.1 to 6.0.2 by [@&#8203;dependabot](https://github.com/dependabot)\[bot] in [#&#8203;1482](abiosoft/colima#1482)
- core: update disk images by [@&#8203;abiosoft](https://github.com/abiosoft) in [#&#8203;1484](abiosoft/colima#1484)
- Multiple minor updates by [@&#8203;abiosoft](https://github.com/abiosoft) in [#&#8203;1485](abiosoft/colima#1485)
- incus: use RFC 5737 IPv4 network for the default network by [@&#8203;jessa0](https://github.com/jessa0) in [#&#8203;1487](abiosoft/colima#1487)
- nerdctl: propagate CONTAINERD\_\* and NERDCTL\_\* environment variables. by [@&#8203;abiosoft](https://github.com/abiosoft) in [#&#8203;1491](abiosoft/colima#1491)
- chore: improve downloader by [@&#8203;abiosoft](https://github.com/abiosoft) in [#&#8203;1492](abiosoft/colima#1492)
- build(deps): bump golang.org/x/term from 0.33.0 to 0.39.0 by [@&#8203;dependabot](https://github.com/dependabot)\[bot] in [#&#8203;1493](abiosoft/colima#1493)
- build(deps): bump github.com/sirupsen/logrus from 1.9.3 to 1.9.4 by [@&#8203;dependabot](https://github.com/dependabot)\[bot] in [#&#8203;1494](abiosoft/colima#1494)
- build(deps): bump github.com/spf13/cobra from 1.9.1 to 1.10.2 by [@&#8203;dependabot](https://github.com/dependabot)\[bot] in [#&#8203;1495](abiosoft/colima#1495)
- incus: make instance ips host reachable by [@&#8203;abiosoft](https://github.com/abiosoft) in [#&#8203;1496](abiosoft/colima#1496)
- incus: improve defaults by [@&#8203;abiosoft](https://github.com/abiosoft) in [#&#8203;1497](abiosoft/colima#1497)
- core: support AI models by [@&#8203;abiosoft](https://github.com/abiosoft) in [#&#8203;1499](abiosoft/colima#1499)
- chore: minor updates by [@&#8203;abiosoft](https://github.com/abiosoft) in [#&#8203;1500](abiosoft/colima#1500)
- chore: improve terminal experience for AI runner model setup. by [@&#8203;abiosoft](https://github.com/abiosoft) in [#&#8203;1502](abiosoft/colima#1502)
- build(deps): bump golang.org/x/term from 0.39.0 to 0.40.0 by [@&#8203;dependabot](https://github.com/dependabot)\[bot] in [#&#8203;1503](abiosoft/colima#1503)
- chore: improve terminal for long subprocess outputs by [@&#8203;abiosoft](https://github.com/abiosoft) in [#&#8203;1504](abiosoft/colima#1504)
- Docs update by [@&#8203;abiosoft](https://github.com/abiosoft) in [#&#8203;1505](abiosoft/colima#1505)

#### New Contributors

- [@&#8203;mlbiche](https://github.com/mlbiche) made their first contribution in [#&#8203;1428](abiosoft/colima#1428)
- [@&#8203;zachcb](https://github.com/zachcb) made their first contribution in [#&#8203;1451](abiosoft/colima#1451)
- [@&#8203;jylenhof](https://github.com/jylenhof) made their first contribution in [#&#8203;1456](abiosoft/colima#1456)
- [@&#8203;Guilospanck](https://github.com/Guilospanck) made their first contribution in [#&#8203;1447](abiosoft/colima#1447)
- [@&#8203;jessa0](https://github.com/jessa0) made their first contribution in [#&#8203;1487](abiosoft/colima#1487)

**Full Changelog**: <abiosoft/colima@v0.9.1...v0.10.0>

</details>

---

### Configuration

📅 **Schedule**: Branch creation - At any time (no schedule defined), Automerge - At any time (no schedule defined).

🚦 **Automerge**: Disabled by config. Please merge this manually once you are satisfied.

♻ **Rebasing**: Whenever MR becomes conflicted, or you tick the rebase/retry checkbox.

🔕 **Ignore**: Close this MR and you won't be reminded about this update again.

---

 - [ ] <!-- rebase-check -->If you want to rebase/retry this MR, check this box

---

This MR has been generated by [Renovate Bot](https://github.com/renovatebot/renovate).
<!--renovate-debug:eyJjcmVhdGVkSW5WZXIiOiI0Mi45Ny4zIiwidXBkYXRlZEluVmVyIjoiNDIuOTcuMyIsInRhcmdldEJyYW5jaCI6Im1haW4iLCJsYWJlbHMiOlsiUmVub3ZhdGUgQm90IiwiYXV0b21hdGlvbjpib3QtYXV0aG9yZWQiLCJkZXBlbmRlbmN5LXR5cGU6Om1pbm9yIl19-->
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

2 participants