Table of Contents
Homey knowledge database
Migrating to new Homey
Community info
https://community.homey.app/t/howto-homey-backup-and-restore-homey-migration/25732
By Dijker
Homey makes by default a daily full backup to the could and keeps the last 7 backups available. You will be able to restore a complete configuration including Zigbee and Z-Wave inclusions (Pairings) but be aware it installs all previous installed apps from the app store. See my notes and warnings below!
As noted by Athom: Do not run multiple Homeys with the same config in the same environment! Powerdown and Reset the migrated Homey.
For replacing a defective Homey you don’t have much choice but for migrating from a good working Homey to for example a Homey Pro I would advice te plan and take time to migrate and verify. Just don’t reset a Working homey if you have not verified the restore is working.
Tips:
Take your time and plan the migration;
Check if you have Apps in use that are installed using CLI (have them ready to reinstall);
Check if Apps you have installed are removed from the App store (plan for an alternative);
Check if you have flows (maybe devices) that are broken, remove them! The wont work anyway and distract from the real issues;
TestPlan: Plan / write down what you want to check after migration, it will help to test quickly;
Make notes from settings information for apps (Like: Server names, IP Addresses, Usernames and Passwords) Create a backup from app that support that (fe BetterLogic, CountDown timers * );
Check the Developer site Zigbee and Z-Wave. https://developer.athom.com/tools/zigbee 95 Remove defective devices (fe Broken, Unknown ) and count the # devices/nodes. (just to verify.)
Create a “last” backup before you start in your original Homey, then when successful Power down your Homey!
Start (Powerup) your New Homey, start after at least ~30 seconds running the recovery (Orange) Connect Wifi (Green?) and Choose to restore a Backup. Choose the last backup you created just before;
Give Homey time, it will take time to download the backup (including Settings, Devices, Flows, Insights) and voice and restart. (Ledring Blue, Purple, Yellow …);
When Homey is ready, Give her more time! it will take time to download, install and start all your Apps! (Ledring Blue);
Reinstall all your CLI installed Apps to repair broken devices and flows;
Check if All Apps are running.
Check if you see Devices with problems (Broken, Spinning donut)
Check if you see broken flows!
Check the Developer site Zigbee and Z-Wave Homey Developer Tools 95 (Does the number of devices correspond?)
Test your most important devices by switching them once on/off and verify fe a coupe of motion sensors and door contacts.
If Zigbee or Zwave devices or RF devices don’t work:
Have you placed the New Homey in the same location?
Power cycle a couple of Z-wave and Zigbee sockets (to clear internal counters referring to the old Homey) and re-test.
PtP for once, Power cycle Homey give her a couple of minutes to cool down, power her up and take a drink (Coffee, good wine, beer, enjoy it first …) and then test again!
If everything seems OK, Congrats! You have successfully migratie your Homey to a new Homey! Don’t Forget to Finish up! or if it wasn’t what you expected read the Rollback procedure!
Reconnect your external device to this Homey:
Google Home, Alexa, Etc. … (Not yet tested)
Change the IP Reservation in your Router for the new Homey to the old (if you needed that tor something)
Change the IP/Cloud ID/URL/Bearer for external incoming connections you might have created once.
Configure (verify) Backup for your New Homey, and Press backup Now to verify a successful backup.
etc.
Don’t forget to Reset your old Homey (Powerup, after ~ 30 Seconds Roll over and use Recovery to reset her)
Troubleshooting Procedure:
If it didn’t work, ask yourself why didn’t this work? Have you tested this the same way before the restore?
Is it due to a know Issue? (Missing App or Newer App from store restored)
Is something not working that normally should work after a restore (fe Missing Zigbee or Z-wave Devices in Developer site, missing users or missing Apps that are available in the app store)
For This Last one, make screenshots of errors, Submit a Log from Homey to Athom and describe what you see and What you have done (and date/time of your backup you restored) Create a support ticket on the Athom support site. (Just because I know Bug and Error free software is an illusion! )
If it is an Community App inform the developer with this information and/or describe your issue with as much info possible here on the Community forum!
Rollback Procedure:
Then, after troubleshooting, powerdown your Failed migrated Homey (Or Reset it to factory Defaults)
Powerup your old Homey and plan your migration again.
Notes and WARNINGS:
WARNING: Manual installed (CLI) apps will be missing from your restored Homey, I have not yet tested this but expect it should work by reinstalling these apps after a restore. So you still need the local sources!
WARNING: Installed Apps that have been removed from the Appstore will be missing! No solution that I know beside a CLI install if you have a download/fork of the original App (Git) Source.
WARNING: Installed (old) Apps that have been updated in the Athom App store will be reinstalled with the newest version published in the store. This can contain updates with breaking changes.
Update 20200218: Tested on request to backup a Homey with a CLI installed app with Devices and Flows. Used a “Simple” RF433 App (Currently half functioning 1) and restored to 2nd Homey. For What I can see Devices and Flows are “Broken” until you re-install the CLI Installed App. After re-install from CLI it just works as before. Used Community Backup & Restore for Homey 58 to verify the restore / reinstall and verified the Device working as before. (I expect it is also working for other Apps with fe Z-Wave or Zigbee Devices, pls let me know!)
Athom info
Webhook
Local webhook Homey2023
http://<Homey IP address>/webhook?event=webhooktest&tag=testing_tag