---
title: install()
framework: virtualization
role: symbol
role_heading: Instance Method
path: virtualization/vzmacosinstaller/install()
---

# install()

Start installing macOS.

## Declaration

```swift
func install() async throws
```

## Mentioned in

Installing macOS on a Virtual Machine

## Discussion

Discussion This method starts the installation process. The VM must be in a stopped state. During the installation operation, pausing or stopping the VM results in an undefined behavior. If you start the installation on the same VZMacOSInstaller object more than once, the framework raises an exception. Call this method only on the VM’s queue.

## See Also

### Installing macOS

- [install(completionHandler:)](virtualization/vzmacosinstaller/install(completionhandler:).md)