Why
The install docs talk about Docker Desktop memory. Many macOS users run Colima instead. A Colima profile with too little memory, or a compose project outside $HOME, fails in ways that look like OceanBase bugs.
Suggested change
In README.md or docs/operations/troubleshooting.md, add a short Colima note:
- Give the Colima profile at least 10 GiB RAM (same bar as Docker Desktop).
- Keep the clone under
$HOME so the VM can mount the working directory (backup temp dirs already follow this).
- Example:
colima start --memory 11 --disk 60.
No code change required unless you also want docker-resources.sh to detect Colima in the error text.
Acceptance
A new user who only has Colima can follow the README without guessing Desktop-only settings.
Why
The install docs talk about Docker Desktop memory. Many macOS users run Colima instead. A Colima profile with too little memory, or a compose project outside
$HOME, fails in ways that look like OceanBase bugs.Suggested change
In
README.mdordocs/operations/troubleshooting.md, add a short Colima note:$HOMEso the VM can mount the working directory (backup temp dirs already follow this).colima start --memory 11 --disk 60.No code change required unless you also want
docker-resources.shto detect Colima in the error text.Acceptance
A new user who only has Colima can follow the README without guessing Desktop-only settings.