Skip to content

# Provisioning

Automatically create a macOS guest user account on first boot — no interactive setup assistant required.

> 📸 Screenshot:

> Availability: Visible only when the host is running macOS 27 or later and the VM OS is set to macOS.

## Fields

Field | Description
--- | ---
Enable | Turn on automated first-boot account setup for this VM.
Full Name | Display name for the new account (e.g. `John Appleseed`).
Username | Short login name for the new account (e.g. `john`). Must not match any existing username on the host Mac.
Password | Login password for the new account. Stored encrypted in the VM configuration.
Auto Login | Log in to this account automatically when the guest starts.
Remote Login | Enable SSH access on the guest for this account.

## Username Requirement

The guest username must differ from all usernames on the host Mac, including your own login name. Using the same username as the host will cause provisioning to fail silently — the account will not be created.

Choose a username that is unique to the guest, for example `vmadmin` or `guestuser`.

## How It Works

When provisioning is enabled, VirtualProg applies the account details on the first boot after macOS installation, allowing macOS to skip the interactive setup assistant and create the account automatically.

Provisioning runs once only — on the restart immediately following installation. After that, the account exists on the guest disk and the provisioning settings have no further effect.

## Password

The password is stored encrypted in the VM configuration file. To update it, type a new value and save. To keep the existing password, leave the field blank — a reminder below the field confirms this when a password is already set.

Disabling provisioning removes the stored password.

## Requirements

All three fields — Full Name, Username, and Password — are required when provisioning is enabled. The configuration cannot be saved until all three are filled in.