This guide will help you to migrate your Home to another AppleID.

We recommend using two devices for the migration.

• Source Device: A device logged into the current AppleID that contains the HomeKit setup.
• Target Device: A device logged into the new AppleID

To keep this guide more straightforward, we will only call them Source Device and Target Device from now on.

Preparations

There are a few things you can do to make the migration easier.

Limitations

Please read through the backup limitations before you migrate your Home. Everything that Controller can't backup also won't be migrated. You will need to recreate these parts manually. It might be a good idea to create some screenshots before you continue to make this easier later.

HomeKit Codes

You will need to reconnect all your Accessories to the new Home. Reconnecting will be faster if you add all your HomeKit Codes to Controller before migrating the Home. The Codes will be migrated as a part of the Backup and displayed when you need them. You can also print them out to make scanning even faster.

Create a Backup

To migrate your Home, you need to create a Backup of your Home and restore it on your Target Device. You have two options to get a Backup of the Home to the Target Device.

1. Invite the new AppleID into your Home and create the Backup with the new AppleID. (Recommended)
2. Create an iCloud Backup and transfer the .backup file from the old iCloud Account to the new one.

Option 1: Invite AppleID Into Your Home (Recommended)

Allow the new AppleID to control your Home and give it all permissions. You can read how to do this in Apple's documentation. Use the Source Device to do this.

Install Controller on the Target Device. Then tap or click on the house in the top-right corner and switch to the Home you want to migrate. Next, go to Backups and create a new one. Controller will guide you through the necessary steps.

Option 2: iCloud Backup

Open Controller on the Source Device. Go to "Settings" from the menu and make sure to select "iCloud" as Backup location.

Then go back to the menu and tap or click on the house in the top-right corner. Switch to the Home that you want to migrate. Go to Backups and create a new one. Controller will guide you through the necessary steps.

Install Controller on the Target Device and open it once. This will make sure, that the “Controller for HomeKit” folder in your iCloud Drive gets created.

Open iCloud Drive, with the Files app, on your Source Device. There is a folder "Controller for HomeKit" that contains your Backup files. Copy the newest Backup into the "Controller for HomeKit" folder in the iCloud Drive of the new AppleID.

(Finder on Mac will not work for this because it won't allow you to add new files to the "Controller for HomeKit" folder.)

Restore your Home

Next, open Controller on the Target Device and create a new home. Then navigate to Backups -> All Backups, and tap or click "Show All Homes" at the bottom of the list. The copied Backup should appear now. Choose it and make sure that you have the correct Backup.

When you restore the new Home, Controller will ask you to connect the Accessories to it. You must remove all Accessories from the old Home before you can do that. Alternatively, you can delete the old Home completely.

Finally, you can restore the Home on the Target Device. Again, Controller will guide you through the required steps.

Congratulations, you have migrated your Home!