Initial Setup

When you open DroidVM for the first time, a step-by-step setup wizard guides you through checking the runtime environment and completing initialization. Please follow the wizard and complete each step in order.

📷 Screenshot placeholder: overall view of the Initial Setup wizard

Setup Steps

Step	Description	Pass Condition
1. Start	Welcome page	Click "Continue"
2. Request Root permission	Requests a root shell, reads the kernel version and SELinux context	Root obtained successfully
3. Check SoC model	Reads the current chip model and compares it against the Gunyah support list	SoC is on the support list (may continue even if not)
4. Check virtualization support	Detects whether /dev/kvm, /dev/gunyah, /dev/gzvm exist	At least one is present
5. File access permission	Requests the "All files access" permission	Granted
6. Privacy agreement	Read and accept the privacy policy	Accepted
7. Extract prebuilt files	Extracts the bundled binaries (crosvm / QEMU / kernel, etc.) to the app directory	Extraction succeeds
8. Setup complete	All checks passed	Enter the main interface

Notes

• Step 4 "Check virtualization support" only appears after root has been obtained; each hypervisor device is marked with ✅ / ❌.
• Steps 5 and 7 are skipped automatically if their conditions are already met.
• When a later screen requires re-checking an item (such as re-granting storage permission), the app jumps directly to the corresponding step.

Granting Root Permission

When the wizard requests root, your root manager (Magisk / KernelSU / APatch) shows an authorization prompt; please choose Allow (it is recommended to check "Allow permanently").

If no prompt appears or authorization fails, check the following:

• Whether DroidVM is on the root manager's authorization list
• Whether the root manager is working correctly

Granting File Access Permission

Step 5 jumps to the system settings page; please turn on the "Allow management of all files" toggle, then return to the app. This permission is used to read and write virtual machine disk images and shared directories.

📷 Screenshot placeholder: the "All files access" permission page

Completion

Once all steps show as passed, click to enter the main interface and you can begin creating your first Virtual Machine.