---
name: build-iso
description: Build a new Archipelago auto-installer ISO image
disable-model-invocation: true
allowed-tools: Bash, Read
---

Build a new Archipelago auto-installer ISO.

## Pre-build checklist

1. Latest code deployed to server (`/deploy` first)
2. System configs synced (`/sync-configs` first)
3. Everything tested and working on live server

## Build (on target server — recommended)

```bash
ssh -i ~/.ssh/archipelago-deploy archipelago@192.168.1.228 'cd ~/archy/image-recipe && sudo ./build-auto-installer-iso.sh'
```

## Copy ISO back to Mac

```bash
scp -i ~/.ssh/archipelago-deploy archipelago@192.168.1.228:~/archy/image-recipe/results/archipelago-auto-installer-*.iso .
```

**IMPORTANT**: Use `build-auto-installer-iso.sh` only. The deprecated `build-debian-iso.sh` causes boot-to-prompt issues.
