여기서 시작하세요:

1vm doctor          # host, entitlements, library, engines
1vm capabilities    # what this specific Mac can and cannot do
1vm logs <vm>       # guest serial and host lifecycle logs

logs는 --source guest|host|all, --lines N, --follow를 받습니다. 대부분의 "그냥 실패했다" 질문은 게스트 serial 마지막 몇 줄로 답됩니다.

모든 머신이 시작에 실패

거의 항상 서명 문제입니다. 앱은 virtualization entitlement가 필요하므로 번들 밖으로 옮기거나 서명이 제거된 바이너리는 아무것도 시작할 수 없습니다. 조각을 복사하지 말고 원본 앱에서 재설치하세요. 1vm doctor가 entitlement 상태를 직접 보고합니다.

머신은 running인데 디스플레이가 없음

1vm logs <vm> --source guest를 확인하세요. 가상 CPU가 존재하는 머신은 펌웨어가 게스트까지 가지 못해도 running으로 보고됩니다 — "running" + 검은 화면은 보통 엔진 위의 부팅 실패이지 창 누락이 아닙니다.

Virtualization.framework 폴백 엔진의 Windows에서는 디스플레이 드라이버가 바인딩될 때까지 Setup 화면이 검은 것이 정상입니다. 드라이버 없이 Setup을 켜는 ramfb가 있는 1VM 엔진을 사용하세요.

x86 ISO가 부팅되지 않음

불가능합니다. 두 엔진 모두 Apple silicon에서 게스트 코드를 네이티브 실행하므로 게스트는 ARM64여야 합니다. 에뮬레이션 경로나 변환 없음 — OS의 ARM64 빌드가 필요합니다. 가장 흔한 놀람이며 Omarchy 가이드가 자세히 설명하는 이유입니다.

Windows에 네트워크 없음

virtio-win의 NetKVM 드라이버를 설치하세요. Windows에는 NVMe와 xHCI 내장 드라이버가 있어 디스크와 키보드는 바로 작동하지만 virtio-net에는 없습니다. 생성 시 --drivers로 드라이버 ISO를 연결하세요.

설치 중 게스트 메모리 부족

설치 프로그램이 실행 중 시스템이 아니라 메모리 최고점입니다. 머신에 메모리를 더 주고 재시도:

1vm stop dev --force
1vm set dev memory 8GiB
1vm start dev

Mac 자체가 압박이면 1VMTool은 프로필을 낮추고 조용히 오버커밋하지 않고 알립니다.

키보드가 게스트에 고정됨

릴리스 코드 탭 — 콘솔 상태 표시줄에 해당 창의 활성 조합이 표시됩니다. 설정 가능:

1vm get dev input.releaseChord

설정이 변경되지 않음

실행 중 머신의 하드웨어 변경은 설정이 명시적으로 지원하지 않으면 거부됩니다. 머신 중지, 변경, 시작. 설정은 설정 시 검증되므로 오류는 다음 부팅이 아니라 실제 문제를 명명합니다.

스크립트가 멈추거나 경쟁

sleep 대신 1vm wait-ready <vm>을 사용하세요. "running"은 머신 실행 중, "ready"는 SSH 또는 게스트 에이전트로 게스트 도달 가능을 의미합니다. 그 간격이 불안정한 스크립트가 사는 곳입니다.

동작하는 상태로 돌아가기

1vm discard-session dev --force   # undo everything since this boot
1vm snapshot restore dev clean    # go to a named snapshot
1vm reset dev --force             # back to the clean state

스냅샷을 건너뛰었다면 지금 시작할 때입니다. 비용 없음 — 그게 요점입니다.