Migration Assistant

Migration Assistant is a built-in macOS tool that helps set up a new Mac. It transfers user data, apps, settings, and files from an old device to the new one — so nothing has to be set up from scratch.

Starting with macOS 26.4, Apple supports managing Migration Assistant through Declarative Device Management (DDM). Relution 26.3 implements this support fully: settings can be pushed to devices via policy, and the current migration status is reported back to Relution as a status report.

The configuration requires macOS 26.4 or later and a supervised device.

Settings Declaration

New in 26.3

Migration Assistant Settings in Relution showing toggles for Enable managed migration and Migrate security and privacy settings, plus list fields for Excluded accounts, Excluded paths, and Required paths

Enable managed migration

Activates managed migration on the device. While this toggle is off, no further restrictions apply. The toggle is off by default.

Migrate security and privacy settings

Determines whether security and privacy settings are transferred from the source to the new device. When disabled, only user data is migrated; system-wide security settings remain at their default state. The option is off by default.

Excluded accounts

List of user accounts to be excluded from the migration process. Each entry is the short name of a user account. Account names can be added individually using the + button.

Examples:

Account nameUse case
administratorLocal admin account should not be transferred
guestuserTemporary guest account to exclude

Excluded paths

List of files and directories that will not be migrated. Paths can be added individually using the + button.

Paths are relative to the user’s home directory and must not start with / or ~; directory paths end with /. Invalid entries are rejected when they are added. System-wide paths outside the home directory cannot be specified.

Examples:

PathUse case
Library/Caches/Cache data will be rebuilt on the target device
Downloads/Temporary downloads are not transferred
Documents/Excluded/A specific documents folder is left behind

Required paths

List of files and directories that must be migrated. If a required path is missing on the source device, the migration is aborted. Paths can be added using the + button. The same format rules apply as for Excluded paths.

Examples:

PathUse case
Documents/Work documents must be transferred completely
Library/Keychains/Keychains are required for operation

Status Reports

Relution automatically reads two status reports from the device. After selecting the device under Devices → Inventory, the values appear on the Information tab in the Device details card. The entries are only shown once the device has reported the respective values.

Migration state

The Migration Assistant entry shows the current state of Migration Assistant on the device:

StateMeaning
WaitingMigration Assistant has not been started yet or no migration has taken place
MigratingThe migration is currently running
CompletedThe migration completed successfully
FailedThe migration failed
CancelledThe user cancelled the migration
UnknownThe device reports a state that Relution cannot map

Migration report

Contains detailed information about the completed migration:

  • Source user: user account on the source Mac
  • Target user: user account on the new Mac
  • Start time and Completion time: start and end of the migration
  • Files transferred: files transferred compared to the total number of files
  • Data transferred: amount of data transferred compared to the total data size
  • Errors: errors reported during the migration

Configuration in Relution

  1. Under Devices → Policies, create a macOS policy via Add or open an existing macOS policy.
  2. Select the Migration Assistant Settings configuration via Add.
  3. Enable Enable managed migration.
  4. Configure the desired accounts and paths.
  5. Save the configuration, publish the policy and assign it to the target devices.

Each policy can contain one Migration Assistant Settings configuration. If a device receives several of these configurations through multiple policies, only one of them is transferred to the device.

How helpful was this article?