utmapp / utmapp/UTM

The macOS shared directories documentations on mount_virtiofs is out of date

Open
#7,677 1 comment 1 reaction 0 assignees View on GitHub
Dominant language
Swift
Stars
35.5k
Forks
1.8k
Avg merge
5d 5h
Merged PRs (30d)
7

Description

The [shared directories](https://docs.getutm.app/guest-support/macos/#shared-directories) documentation for macOS talks about:

> mount_virtiofs share [mount point]

inferring that `share` is an fs_tag that `mount_virtiofs` will recognize. However, trying that gave me the error:

```
mount_virtiofs: fs_tag share not found
```

The UTM source code now appears to [prefer using macOSGuestAutomountTag](https://github.com/utmapp/UTM/blob/30c8202c630c5af2e3c3403df1bb95c962459bc6/Configuration/UTMAppleConfiguration.swift#L314-L320) as the tag, which seems to have the value `com.apple.virtio-fs.automount`.

Running the following in the guest worked for me:

```
mkdir -m 777 -p ~/my-shared-files
sudo umount "/Volumes/My Shared Files"
sudo mount_virtiofs com.apple.virtio-fs.automount ~/my-shared-files
```

Perhaps the documentation could be updated to integrate this information (perhaps keeping `~` paths to show that those work, and that you don't need the path to be under `/Volumes` as I've seen claimed elsewhere).

Backstory: in my case I need to do this because I want to build some software in the guest that absolutely refuses to build if there are spaces in (normalized) paths.

Thanks for all the work to bring us UTM!

**Configuration**
* UTM Version: 4.7.5 (118)
* macOS Version: 26.4
* Mac Chip: M3

Contributor guide

Open the contributing guide

Assessment

This issue has not been assessed yet.

Get new issues in your inbox

A short digest of beginner-friendly GitHub issues.