Schedule a migration

Scheduling allows you to set your migration to run automatically at times you set yourself so that you can easily run your migration in intervals or at off-hours.

You can view or cancel all of your currently running scheduled tasks from Tasks.

Index

• How-to
• Default behavior

How-to

1. Click Copy.
2. Select your migration type from the menus. Your options are:
   • Copy structure and content.
   • Copy content only.
   • Copy teams.
   • Copy teams - Incremental.
   • Import from file share.
   • Import from Google Drive.
3. Click the Schedule button.
4. Set the Task name, Start date, Start time, and Recurrence (optional) for the migration. 
5. Click Schedule.

You will be brought to the Scheduled screen where you will see the new task with all your other scheduled tasks. 

For more information on how to edit or modify your scheduled tasks, see Manage your scheduled tasks.

Note: You cannot schedule a migration when using the Excel Import and copy option.

Default behavior

• The ShareGate migration tool needs to remain open in the system tray for scheduled migrations to run automatically.
• The ShareGate migration tool uses your global migration settings at the moment your scheduled migration occurs. Ensure your settings reflect your preferences for the scheduled migration (i.e. Normal mode or Insane mode, Illegal characters, etc.).
• If your cookies expired, there will be a pop-up to re-enter your credentials before the migration can run as scheduled.
• If you are using the Browser authentication method, contact your IT team or Microsoft 365 admin to request that your authentication token does not expire.  
• If one or more occurrences were missed because the ShareGate migration tool was closed, when you restart it you will see a pop-up asking if you want to run the scheduled migration. It will not run until you select your preference.
• A scheduled migration runs as long as the ShareGate migration tool is open in the system tray, and will still run if your computer is locked, but not if you are logged off or in sleep mode. 
• When using a virtual machine (VM), you need to have a persistent desktop (an image that persists between reboots) to ensure the scheduled migration is saved.
• If you are using a remote server session, the scheduled migration will run as long as the server is not asleep.
• You cannot set the results of a scheduled migration to automatically export or be sent out as an email. This can be done manually once the task is finished running.