Managed Migration Assistant declarative configuration for Apple devices

You can use your device management service to migrate the content of a user’s Home folder from one Mac computer to another managed Mac computer. This process uses Setup Assistant to migrate subfolders in the user’s Home folder. You can specify exactly which subfolders get migrated in the declarative configuration of the device management service. If the Home folder contents on the original Mac exceed the storage capacity of the Mac you want to migrate to, priority is given to the content listed in the RequiredPaths attribute.

This configuration supports the following:

  • Minimum supported operating system versions and channels:  macOS 26.4 device.

  • Requires supervision: Yes.

  • Supported enrollment methods: Automated Device Enrollment.

The user’s Library folder (~/Library) is always migrated. Other items available for migration are shown in the table below:

Item

Available for migration

Visible folders in the user’s Home folder

Yes

Hidden folders in the user’s Home folder (for example, .ssh, .bash_history, .Trash)

Yes

Folder aliases or sym links in the user’s Home folder (Original folders outside of the user’s home folder won’t get migrated.)

Yes

Visible and hidden files inside the user’s Home folder

Yes

Privacy and security settings

Yes

File aliases and sym links in the user’s Home folder

No

Any folders and files in /Users/Shared/ owned by the user

No

Any folders, files, and apps in the /Applications folder

No

Other System Settings

No

Printers and other services

No

Published Date: March 24, 2026
Morty Proxy This is a proxified and sanitized view of the page, visit original site.
Helpful?
Character limit: 250
Maximum character limit is 250.
Thanks for your feedback.
Morty Proxy This is a proxified and sanitized view of the page, visit original site.