Migrate a User Profile on a Mac

On a macOS computer, the AD Bridge domain join utility includes a tool to migrate a user's profile from a local user account to the home directory specified for the user in Active Directory.

When you migrate the user's profile, you can either copy or move it from the local account to the user's Active Directory account. Copying the profile leaves a copy of the user's files in their original location, but it doubles the space on the hard disk required to keep the user's files.

You can migrate a user through the command line. In addition, you can customize the migration shell script to suit your requirements.


To migrate a user's profile, you must have a local or AD account with administrative privileges. The account that you use must not be the account that you are migrating.

As of AD Bridge 9.1.0, the user interface no longer performs migrations. Migrations must be performed by using the command line. For documentation about previous versions of AD Bridge, please see the BeyondTrust AD Bridge Documentation Archives.

Migrate from the Command Line

You can migrate a user's profile using the command line. On a Mac, the migration shell script is located at /opt/pbis/bin/lw-local-user-migrate.sh.

You can run the script locally or remotely. To remotely migrate users from another computer, connect to a Mac using SSH and then run the migration script.

For information about the command's syntax and arguments, execute the following command in Terminal:

/opt/pbis/bin/lw-local-user-migrate.sh --help

If you need to modify the migration script, you can open and edit it. The script is written in Bash shell.


BeyondTrust Technical Support does not assist with customizing scripts or provide support for modified scripts.