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.
Settings Declaration
New in 26.3
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 name | Use case |
|---|---|
administrator | Local admin account should not be transferred |
guestuser | Temporary 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:
| Path | Use 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:
| Path | Use 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:
| State | Meaning |
|---|---|
| Waiting | Migration Assistant has not been started yet or no migration has taken place |
| Migrating | The migration is currently running |
| Completed | The migration completed successfully |
| Failed | The migration failed |
| Cancelled | The user cancelled the migration |
| Unknown | The 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
- Under
Devices→Policies, create a macOS policy via Add or open an existing macOS policy. - Select the Migration Assistant Settings configuration via Add.
- Enable Enable managed migration.
- Configure the desired accounts and paths.
- 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.