mirror of
https://github.com/cirruslabs/tart-guest-agent.git
synced 2026-09-30 03:41:55 +02:00
Nikolay Edigaryev
da981a8760
* Automatically install and start a systemd service * Use Bash and set shell options to enable fail-fast behavior * Ensure that we're performing disk manipulations on Tart 2.0.0 or newer
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
- Clipboard sharing for macOS VMs using our in-house SPICE vdagent implementation (
--run-vdagent)- needs to be invoked as a launchd global agent
tart execsupport (--run-rpc)- it's recommended to invoke it as a launchd global agent because fewer privileges will be available to commands started via
tart exec - however, you can also invoke it as a launchd global daemon if running commands started via
tart execasrootis desired
- it's recommended to invoke it as a launchd global agent because fewer privileges will be available to commands started via
tart ip --resolver=agentsupport (--run-rpc)- allows resolving VM's IP address without relying on DHCP leases and/or an ARP table
To run all features appropriate for a given context, use component groups:
--run-daemon- implies
--resize-disk - example usage:
tart-guest-daemon.plist
- implies
--run-agent- implies
--run-vdagent --run-rpc - example usage:
tart-guest-agent.plist
- implies