23 lines
1.4 KiB
Markdown
23 lines
1.4 KiB
Markdown
# Guest agent for Tart VMs
|
|
|
|
A guest agent for Tart VMS is a lightweight background service that runs inside the virtual machine and enables enhanced communication between the host and guest and other useful features, such as automatic disk resizing.
|
|
|
|
Currently implemented features:
|
|
|
|
* Automatic disk resizing for macOS VMs with recovery partition removed (`--resize-disk`)
|
|
* needs to be invoked as a launchd [global daemon](https://launchd.info/)
|
|
* Clipboard sharing for macOS VMs using our in-house SPICE vdagent implementation (`--run-vdagent`)
|
|
* needs to be invoked as a launchd [global agent](https://launchd.info/)
|
|
* `tart exec` support (`--run-rpc`)
|
|
* it's recommended to invoke it as a launchd [global agent](https://launchd.info/) because fewer privileges will be available to commands started via `tart exec`
|
|
* however, you can also invoke it as a launchd [global daemon](https://launchd.info/) if running commands started via `tart exec` as `root` is desired
|
|
|
|
To run all features appropriate for a given context, use component groups:
|
|
|
|
* `--run-daemon`
|
|
* implies `--resize-disk`
|
|
* example usage: [`tart-guest-daemon.plist`](https://github.com/cirruslabs/macos-image-templates/blob/main/data/tart-guest-daemon.plist)
|
|
* `--run-agent`
|
|
* implies `--run-vdagent --run-rpc`
|
|
* example usage: [`tart-guest-agent.plist`](https://github.com/cirruslabs/macos-image-templates/blob/main/data/tart-guest-agent.plist)
|