First-Run Onboarding

The first time you launch Kyvenza, a five-step wizard confirms your Mac is ready before you create any VMs. You can change every choice later in Settings.

Step 1 — Welcome

An overview of what Kyvenza does and what it needs: Apple Silicon, macOS 14 or later, and a storage location with enough free space.

Step 2 — System Compatibility

Kyvenza runs four checks against your Mac:

Check	What it verifies
Apple Silicon	The Mac uses an Apple Silicon chip. Intel Macs fail this check.
macOS Version	macOS 14 (Sonoma) or later is installed.
Disk Space	The chosen storage path has enough free space for VM images. A warning appears if space is tight.
Permissions	Kyvenza can create and maintain files in the chosen directory.

If Apple Silicon fails, Kyvenza cannot run on this Mac. Other failures are usually recoverable (free up disk space, grant folder access, or pick a different storage path).

Step 3 — Requirements & Notices

A read-only summary of the results from Step 2 plus product notices — legal and operational information you should acknowledge before running guests.

Step 4 — Storage Location

Pick the folder where Kyvenza stores VM images, snapshots, and metadata.

Recommendations:

• Use an internal SSD for best I/O performance.
• Avoid iCloud Drive, Desktop, or Documents folders — iCloud sync can corrupt live VM files.
• External drives work, but keep them connected while VMs are running.

You can change this path later in Settings, but existing VMs will not move automatically.

Step 5 — Analytics & Crash Reporting

Choose whether Kyvenza may send anonymous usage analytics and crash reports. Both are off by default and can be toggled at any time in Settings → General.

After onboarding

Kyvenza opens the main window, ready for you to create your first VM.