From 68691eafcfb1a0c7921a8e4cb9b6fe019ad6d192 Mon Sep 17 00:00:00 2001 From: Matt Van Horn Date: Sun, 19 Apr 2026 02:39:33 -0700 Subject: [PATCH] docs: link UTM-on-macOS install walkthrough from Quick Start Closes #36 Points users who want filesystem isolation from the Mac host at the community-maintained UTM install guide (mayurjobanputra/AlphaClaw-in-UTM-on-Mac), which already covers the full flow: UTM install, Apple Silicon vs Intel ISO selection, UTM VM configuration, and the Ubuntu guest install steps. Notes the 8 GB RAM / 4 CPU / 30 GB disk recommendation called out in that guide, and points readers back at the existing Local / Docker steps once the VM is up so the UTM path reuses the same install surface as the rest of the Quick Start section. --- README.md | 6 ++++++ 1 file changed, 6 insertions(+) diff --git a/README.md b/README.md index f004be9c..35bea893 100644 --- a/README.md +++ b/README.md @@ -86,6 +86,12 @@ EXPOSE 3000 CMD ["alphaclaw", "start"] ``` +### UTM (macOS virtual machine) + +To run AlphaClaw inside a full virtual machine on a Mac (for maximum isolation from the host filesystem), use [UTM](https://mac.getutm.app) with Ubuntu Server. A community walkthrough covers the full flow, from UTM install to Apple Silicon vs Intel ISO selection to recommended VM resources (8 GB RAM, 4 CPU, 30 GB disk): [AlphaClaw in UTM on Mac](https://github.com/mayurjobanputra/AlphaClaw-in-UTM-on-Mac). + +Once the Ubuntu VM is up, the Local / Docker steps above apply unchanged inside the guest. + ## Setup UI | Tab | What it manages |