Scale computer-use 2.0 with open-source drivers, cross-OS sandboxes, and benchmarks for training, evaluation, and data generation.
Rust agentai-agentapplecomputer-usecomputer-use-agentcontainerizationcuadesktop-automationhacktoberfestlumemacosmanusoperatorswiftvirtualizationvirtualization-frameworkwindowswindows-sandbox
docs(lume): add custom storage locations and Linux VM documentation (#822)
Francesco Bonacci94c761e34425
diff --git a/docs/content/docs/lume/guide/fundamentals/vm-management.mdx b/docs/content/docs/lume/guide/fundamentals/vm-management.mdxindex a7828bb137..6334f3d13b 100644--- a/docs/content/docs/lume/guide/fundamentals/vm-management.mdx+++ b/docs/content/docs/lume/guide/fundamentals/vm-management.mdx@@ -45,6 +45,37 @@ Mount a disk image as USB storage (macOS 15+ only):lume run my-vm --usb-storage /path/to/disk.img```+## Linux VMs++Lume supports Linux VMs using ARM64 ISO images. The workflow differs slightly from macOS.++### Create and install++```bash+# Create empty VM configured for Linux+lume create ubuntu-vm --os linux --cpu 4 --memory 8GB --disk-size 50GB++# First boot: mount installer ISO+lume run ubuntu-vm --mount ~/Downloads/ubuntu-24.04-live-server-arm64.iso++# After installation: run normally+lume run ubuntu-vm+```++Complete the installation in the VNC window, shut down, then run without the ISO.++### Supported distributions++Any ARM64 Linux distribution works. Download the ARM64 (aarch64) ISO, not x86_64:++- **Ubuntu** - [ubuntu.com/download](https://ubuntu.com/download)+- **Debian** - [debian.org](https://www.debian.org/)+- **Fedora** - [fedoraproject.org](https://fedoraproject.org/)++<Callout type="info">+Linux VMs have no licensing restrictions—run as many concurrent instances as your hardware supports. Only macOS VMs are limited to 2 per Mac.+</Callout>+## Stop a VM```bashdiff --git a/docs/content/docs/lume/guide/getting-started/quickstart.mdx b/docs/content/docs/lume/guide/getting-started/quickstart.mdxindex e83f04efd1..9da83b1187 100644--- a/docs/content/docs/lume/guide/getting-started/quickstart.mdx+++ b/docs/content/docs/lume/guide/getting-started/quickstart.mdx@@ -41,13 +41,61 @@ lume create my-vm --os macos --ipsw latestThe IPSW file is ~15GB. If you plan to create multiple VMs, downloading manually and reusing the file saves time and bandwidth.</Callout>+## Configure VM storage location (optional)++By default, VMs are stored in `~/.lume`. You can configure custom storage locations before creating VMs—useful for external drives or organizing VMs by project.++```bash+# Add an external drive as a storage location+lume config storage add external /Volumes/MySSD/lume++# Set it as the default for new VMs+lume config storage default external++# View all configured storage locations+lume config storage list+```++When creating a VM, specify which storage to use:++```bash+# Use a named storage location+lume create my-vm --os macos --ipsw latest --storage external++# Or use a direct path+lume create my-vm --os macos --ipsw latest --storage /path/to/vm/directory+```++<Callout type="info">+VM disk images can grow large (~50GB+). Using an external SSD keeps your internal storage free and can improve performance for I/O-heavy workloads.+</Callout>++## Create a Linux VM++Lume also supports Linux VMs using ISO images:++```bash+# Create an empty Linux VM+lume create ubuntu-vm --os linux++# First boot: mount the installer ISO+lume run ubuntu-vm --mount ~/Downloads/ubuntu-24.04-live-server-arm64.iso++# After installation completes, run normally+lume run ubuntu-vm+```++<Callout type="info">+Linux VMs require ARM64 ISO images (not x86). Ubuntu, Debian, and Fedora all provide ARM64 server and desktop images.+</Callout>+## Run your VM```bashlume run my-vm```-A VNC window opens with the macOS Setup Assistant. Complete the setup manually, or use [Unattended Setup](/lume/guide/fundamentals/unattended-setup) to automate it.+A VNC window opens. For macOS VMs, you'll see the Setup Assistant—complete it manually or use [Unattended Setup](/lume/guide/fundamentals/unattended-setup) to automate it.## Create a VM with custom resources