Bắt đầu tại đây:

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 nhận --source guest|host|all, --lines N và --follow. Hầu hết câu "it just failed" được trả lời bởi vài dòng serial guest cuối.

Mọi máy không khởi động

Gần như luôn là chữ ký. App phải mang entitlement virtualization, nên binary đã di chuyển khỏi bundle hoặc strip chữ ký không khởi động gì. Cài lại app gốc thay vì copy từng phần. 1vm doctor báo trạng thái entitlement trực tiếp.

Máy báo đang chạy nhưng không có màn hình

Kiểm tra 1vm logs <vm> --source guest. Máy có CPU ảo được báo đang chạy dù firmware chưa tới guest — "running" cộng màn hình đen thường là lỗi boot trên engine, không phải thiếu cửa sổ.

Với Windows trên engine fallback Virtualization.framework, màn hình Setup đen là bình thường cho đến khi driver hiển thị bind. Dùng engine 1VM, ramfb sáng Setup không cần driver.

ISO x86 không boot

Không thể. Cả hai engine chạy mã guest native trên Apple silicon, guest phải ARM64. Không giả lập hay chuyển đổi — cần bản ARM64 hệ điều hành. Bất ngờ phổ biến nhất, hướng dẫn Omarchy giải thích đầy đủ.

Windows không có mạng

Cài driver NetKVM của virtio-win. Windows có driver sẵn cho NVMe và xHCI, nên đĩa và bàn phím hoạt động ngay, nhưng không cho virtio-net. Gắn ISO driver lúc create với --drivers.

Guest hết bộ nhớ khi cài

Installer là đỉnh bộ nhớ, không phải hệ đang chạy. Cho máy thêm và thử lại:

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

Nếu Mac chịu áp lực, 1VMTool scale profile xuống và báo thay vì overcommit im lặng.

Bàn phím kẹt trong guest

Chạm release chord — thanh trạng thái console hiện tổ hợp đang active. Có thể cấu hình:

1vm get dev input.releaseChord

Cài đặt không đổi

Thay đổi phần cứng trên máy đang chạy bị từ chối trừ khi cài đặt hỗ trợ. Dừng máy, đổi, khởi động. Cài đặt xác thực khi đặt, lỗi nêu vấn đề thật thay vì fail lần boot sau.

Script treo hoặc race

Dùng 1vm wait-ready <vm> thay vì sleep. "Running" nghĩa máy đang thực thi; "ready" nghĩa guest truy cập được qua SSH hoặc guest agent. Khoảng giữa là nơi script hay lỗi.

Quay về trạng thái hoạt động

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

Nếu bạn bỏ qua snapshot, đây là lúc bắt đầu: không tốn gì, và đó là cả ý nghĩa.