How to Migrate UniFi Controller from a Debian 11 on a Raspberry Pi 3B+ to Debian 12 on a 4B

Glossary:

• 4B = 4 Model B
• 3B+ = 3 Model B+

Step 1

Set up the Raspberry Pi 4B

Follow these instructions. I highly recommend doing as much preconfiguration in the Raspberry Pi Imager as you can.

Step 2

Install UniFi Controller

Follow these instructions.

Step 3

Export your UniFi Controller settings on the Raspberry Pi 3B+

Step 4

(If you have a Site set up) Export your Site(s) from UniFi Controller on the Raspberry Pi 3B+

Be sure to follow the onscreen instructions. Do NOT migrate your UniFi devices until they have imported correctly in the new UniFi Controller instance.

Step 5

(If you have a Site set up) enable multi-site in the new UniFi Controller instance

Step 6

Import the Site you exported in Step 4

Pointers.

Step 7

Migrate your existing UniFi devices to the new Controller instance

Repeat Step 4, but instead of exporting the site again, migrate your desired devices. Wait for the UniFi devices from your 3B+ instance to show up in the new instance.

Step 7

Import the settings you backed up in Step 3 into the new Controller instance

Step 8

Forget the migrated devices in the 3B+'s Controller instance

Repeat Step 4, by pass the site export and device migration, and then click Forget

Step 9

(For convenience) link your local UniFi credentials with your UniFi cloud SSO

Step 10

Connect the new instance to the mobile app

Use your cloud SSO credentials to login to the mobile app. Your new installation should show up there.