Upgdate MacOS colima guide

Author: iongion

docs/index.html

@@ -504,13 +504,25 @@ <h3 id="guide-macos-quick-guide"><a href="#guide-macos-table-of-contents"><i cla
             </dd>
             <dt>Start colima VM</a></dt>
             <dd>
-              <code>colima start</code>
+              <code>colima start --vm-type=vz --vz-rosetta</code>
+              <br />
+              <span>The command above will use the native MacOS virtualization framework, allowing even x86 container images to run and avoiding volume mounts file-system permissions issues.</span>
+              <br/>
+              <span class="important-note">You can also use custom distributions images for the docker host os, see here <a target="_blank" rel="noopener noreferrer" href="https://github.com/abiosoft/colima-core/releases">https://github.com/abiosoft/colima-core/releases</a>, in that case, after downloading the image of choice:</span>
+              <code>colima start --vm-type=vz --vz-rosetta --disk-image ~/Downloads/ubuntu-24.04-minimal-cloudimg-arm64-docker.qcow2</code>
             </dd>
-            <dt>Install <a href="https://formulae.brew.sh/formula/docker" target="_blank" rel="noopener noreferrer">docker</a> command line tools</dt>
+            <dt>Install <a href="https://formulae.brew.sh/formula/docker" target="_blank" rel="noopener noreferrer">docker</a> command line tools and plugins.</dt>
             <dd>
-              <code>brew install docker</code> - <span>this does not install Docker Desktop</span>
+              <code>brew install docker docker-compose docker-buildx</code> - <span>this does not install Docker Desktop, only the command line tools that will use the colima docker engine.</span>
+              <br/>
+              <span>For docker cli to find the plugins, add the following to your <code>~/.docker/config.json</code>:</span>
+              <pre>
+"cliPluginsExtraDirs": [
+  "$HOMEBREW_PREFIX/lib/docker/cli-plugins"
+]</pre>
+              <span>After all of the above you should have a completely compatible docker engine running on your mac.</span>
             </dd>
-            <dt>Download and install Container Desktop for MacOS, then due to missing digital signature, allow it to run using</dt>
+            <dt>Not required, but you can also download and install Container Desktop for MacOS, then due to missing digital signature, allow it to run using</dt>
             <dd>
               <code>xattr -d com.apple.quarantine /Applications/Container\ Desktop.app</code>
             </dd>
@@ -562,25 +574,18 @@ <h3 id="guide-macos-podman-as-docker"><a href="#guide-macos-table-of-contents"><
           </dl>
           <h3 id="guide-macos-docker-desktop-alternative"><a href="#guide-macos-table-of-contents"><i class="fa fa-angles-up"></i></a> 4. Docker Desktop alternative</h3>
           <dl>
-            <dt>Using <strong>colima</strong>, prepare a Linux VM with backed-in docker support</dt>
+            <dt>Using <strong>colima</strong> offers the easiest experience</dt>
             <dd>
-              Open a terminal and run the following
-              <br />
-              <code>brew install colima</code>
-              <br />
-              Start the colima VM
-              <br />
-              <code>colima start</code>
+              Just follow the <a href="#guide-macos-quick-guide">Quick guide</a> to support docker in full compatibility.
             </dd>
-            <dt>Adding support for native <strong>docker</strong> binary</dt>
+            <dt><strong>(*)</strong> Optional guide for adding support for native <strong>docker</strong> CLI and plugins binaries without homebrew, not recommended due to complexity in setup</dt>
             <dd>
-              <code>brew install docker</code> - <span>this does not install Docker Desktop</span>
-              <br />
-              Latest <strong>docker</strong> CLI binaries can also be found at
+              Latest <strong>docker</strong> CLI and plugins binaries can also be found at
               <ul>
                 <li><strong>Apple CPUs</strong> - <a href="https://download.docker.com/mac/static/stable/aarch64/" target="_blank" rel="noopener noreferrer">https://download.docker.com/mac/static/stable/aarch64/</a></li>
                 <li>Intel CPUs - <a href="https://download.docker.com/mac/static/stable/x86_64/" target="_blank" rel="noopener noreferrer">https://download.docker.com/mac/static/stable/x86_64/</a></li>
               </ul>
+              <br/>
             </dd>
           </dl>
           <h3 id="guide-macos-sharing-connection"><a href="#guide-macos-table-of-contents"><i class="fa fa-angles-up"></i></a> 5. Sharing connection with Container Desktop</h3>