# \[Modding\]\[HowTo\] Guide to Jailbreak a Homey Pro 2023 **URL:** \ **Category:** Off-Topic\ **Tags:** homey-pro-2023, modding\ **Created:** [June 4, 2023, 4:17pm UTC](https://community.homey.app/t/modding-howto-guide-to-jailbreak-a-homey-pro-2023/81678 "2023-06-04T16:17:01Z")\ **Posts on this page:** 20\ **Page:** 1
**Author:** ![spkesDE](https://sea1.discourse-cdn.com/flex025/user_avatar/community.homey.app/spkesde/32/54352_2.png) [@spkesDE](https://community.homey.app/u/spkesDE)\ **Post date:** [June 4, 2023, 4:17pm UTC](https://community.homey.app/t/modding-howto-guide-to-jailbreak-a-homey-pro-2023/81678/1 "2023-06-04T16:17:01Z")
### Disclaimer: Jailbreaking your Homey Pro may void its warranty and potentially cause irreversible damage. Proceed at your own risk. ### Note: It is recommended to create a backup of your Homey Pro before proceeding with the jailbreak process ## šŸŸ¢ Pro about jailbreaking šŸŸ¢ 1. Hardware Utilization: By modifying the software on your Homey Pro, you can take full advantage of the capabilities of the Raspberry Pi CM4 module. This allows for more efficient resource utilization, potentially improving performance and enabling more demanding applications. 2. Enhanced Monitoring and Debugging: Modifying the software can provide greater access to system logs, debugging tools, and performance monitoring. This can be useful for troubleshooting issues, identifying bottlenecks, or gaining deeper insights into the operation of your Homey Pro. 3. Community Contributions: Modifying the software often encourages community involvement, fostering collaboration and the sharing of custom scripts, plugins, or modifications. This can lead to a broader range of community-driven enhancements and innovations for your Homey Pro. ## šŸ”“ Contra about jailbreaking šŸ”“ 1. Limited Warranty and Support: Modifying the software on your Homey Pro may void the manufacturerā€™s warranty and reduce the level of support available. If you encounter issues or need assistance, you may have to rely on the community or self-help resources, rather than official channels. 2. Device Bricking Risk: There is a possibility that during the modification process, you could make a mistake or encounter compatibility issues that result in your Homey Pro becoming inoperable or ā€œbricked.ā€ This can be challenging to recover from and may require technical expertise to resolve. 3. Need for Re-jailbreaking after Updates: When you modify the software on your Homey Pro, you will typically need to reapply the modifications or ā€œre-jailbreakā€ the device after every official software update. This can be time-consuming and require you to repeat the customization process, reinstall plugins, and reconfigure settings. 4. Security Vulnerabilities: Modifying the software can introduce potential security risks to your Homey Pro. Custom modifications may not benefit from regular security updates or patches, leaving your device more susceptible to exploits or unauthorized access. 5. Complexity and Technical Expertise: Modifying the software on your Homey Pro requires a certain level of technical expertise and familiarity with the underlying technologies. This can be a barrier for individuals who are less experienced or comfortable with advanced software modifications. ## Requirements - A Homey Pro 2023 - EXT4 support on your device ([Win10](https://www.paragon-software.com/home/linuxfs-windows/) | [MacOS](https://www.paragon-software.com/home/extfs-mac/)) - [Raspberry USB-boot tool](https://github.com/raspberrypi/usbboot) | [Windows](https://github.com/raspberrypi/usbboot/blob/master/win32/rpiboot_setup.exe) ## Fast way Currently in Work in Progressā€¦ ## Guide for Linux/MacOS 1. Build USB-boot tools as written in the [GitHub](https://github.com/raspberrypi/usbboot#linux--cygwin--wsl). 2. Install EXT4 drivers, if needed. 3. Connect the Homey Pro in recovery mode by pressing the pin on the underside of the device and then connecting it to your computer via USB-C. 4. Run USB-boot by entering the command `sudo ./rpiboot` in the terminal. 5. Identify the two ROOT partitions (containing `/etc/, /var/, /home/...`). 6. Copy paste & replace (extracted, so it the folders inside) [this file](https://nc.spkes.de/index.php/s/igqeL7bQ6MaFLRH/download/homey.tar.gz) ([Virus Total](https://www.virustotal.com/gui/url/1105331d48b4800eca92f4cdecf4816c0ded6db49f947331cb6f8a49c8d5f073)) in ROOT A & ROOT B 7. Start Homey Pro 2023 8. SSH to the Homey with user: `homey-pro` and password `pro` on port `2222` šŸŽ‰ ## Guide for Windows 10 1. Install USB Tools ([Download Here](https://github.com/raspberrypi/usbboot/blob/master/win32/rpiboot_setup.exe)) & Install EXT4 drivers, if needed. 2. Connect the Homey Pro in recovery mode by pressing the pin on the underside of the device and then connecting it to your computer via USB-C. 3. Run `rpitools` on windows (Find it using your start menu) 4. Let the magic happenā€¦ 5. Identify the two ROOT partitions (containing `/etc/, /var/, /home/...`). 6. Copy paste & replace (extracted, so it the folders inside) [this file](https://nc.spkes.de/index.php/s/igqeL7bQ6MaFLRH/download/homey.tar.gz) ([Virus Total](https://www.virustotal.com/gui/url/1105331d48b4800eca92f4cdecf4816c0ded6db49f947331cb6f8a49c8d5f073)) in ROOT A & ROOT B 6.1 **Unmount /eject /user /rootA and /rootB via LinuxFS** 7. Start Homey Pro 2023 8. SSH to the Homey with user: `homey-pro` and password `pro` on port `2222` šŸŽ‰ Also thanks to @robertklep for the hints šŸ™‚ ---
**Author:** ![spkesDE](https://sea1.discourse-cdn.com/flex025/user_avatar/community.homey.app/spkesde/32/54352_2.png) [@spkesDE](https://community.homey.app/u/spkesDE)\ **Post date:** [June 4, 2023, 4:17pm UTC](https://community.homey.app/t/modding-howto-guide-to-jailbreak-a-homey-pro-2023/81678/2 "2023-06-04T16:17:43Z")
ā€“ Reserved ā€“ ---
**Author:** ![Sharkys](https://sea1.discourse-cdn.com/flex025/user_avatar/community.homey.app/sharkys/32/54029_2.png) [@Sharkys](https://community.homey.app/u/Sharkys)\ **Post date:** [June 4, 2023, 4:36pm UTC](https://community.homey.app/t/modding-howto-guide-to-jailbreak-a-homey-pro-2023/81678/3 "2023-06-04T16:36:29Z")
**Proved to be working šŸ˜‰ Thank you @spkesDE for this guide.** Maybe for Windows users, always try to unmount/eject /user /rootA and /rootB via LinuxFS FIRST before dismounting the other partitions, just to ensure all modifications were written. ---
**Author:** ![Dijker](https://avatars.discourse-cdn.com/v4/letter/d/b9bd4f/32.png) [@Dijker](https://community.homey.app/u/Dijker)\ **Post date:** [June 5, 2023, 5:30am UTC](https://community.homey.app/t/modding-howto-guide-to-jailbreak-a-homey-pro-2023/81678/4 "2023-06-05T05:30:07Z")
Also did the jailbreak, used the Raspberry Pi Desktop VM Works perfect. Now curious but expect it will be overwritten every Firmware release. ---
**Author:** ![robertklep](https://sea1.discourse-cdn.com/flex025/user_avatar/community.homey.app/robertklep/32/160628_2.png) [@robertklep](https://community.homey.app/u/robertklep)\ **Post date:** [June 5, 2023, 5:41am UTC](https://community.homey.app/t/modding-howto-guide-to-jailbreak-a-homey-pro-2023/81678/5 "2023-06-05T05:41:56Z")
> [@Dijker](#): > > Now curious but expect it will be overwritten every Firmware release. It will, firmware update overwrite at least one root partition and switch to it. ---
**Author:** ![rihanna](https://sea1.discourse-cdn.com/flex025/user_avatar/community.homey.app/rihanna/32/73733_2.png) [@rihanna](https://community.homey.app/u/rihanna)\ **Post date:** [June 14, 2023, 7:21am UTC](https://community.homey.app/t/modding-howto-guide-to-jailbreak-a-homey-pro-2023/81678/6 "2023-06-14T07:21:36Z")
Is it possible to do the same to the old 2019 model? ---
**Author:** ![robertklep](https://sea1.discourse-cdn.com/flex025/user_avatar/community.homey.app/robertklep/32/160628_2.png) [@robertklep](https://community.homey.app/u/robertklep)\ **Post date:** [June 14, 2023, 7:37am UTC](https://community.homey.app/t/modding-howto-guide-to-jailbreak-a-homey-pro-2023/81678/7 "2023-06-14T07:37:56Z")
Sadly, no. ---
**Author:** ![rihanna](https://sea1.discourse-cdn.com/flex025/user_avatar/community.homey.app/rihanna/32/73733_2.png) [@rihanna](https://community.homey.app/u/rihanna)\ **Post date:** [June 14, 2023, 4:58pm UTC](https://community.homey.app/t/modding-howto-guide-to-jailbreak-a-homey-pro-2023/81678/8 "2023-06-14T16:58:17Z")
Iā€™m trying to do this on my new 2023 model, but I canā€™t find any partitions with etc/var/home directories. I can find 3 partitions AUTOBOOT/ROOTA/ROOTB Do I still just add the files to the partitions? ---
**Author:** ![spkesDE](https://sea1.discourse-cdn.com/flex025/user_avatar/community.homey.app/spkesde/32/54352_2.png) [@spkesDE](https://community.homey.app/u/spkesDE)\ **Post date:** [June 14, 2023, 5:29pm UTC](https://community.homey.app/t/modding-howto-guide-to-jailbreak-a-homey-pro-2023/81678/9 "2023-06-14T17:29:33Z")
It should be ROOTA and ROOTB. They should be a couple of folders (etc, var, home, libā€¦) and a VERSION file. That is the right partition. ---
**Author:** ![robertklep](https://sea1.discourse-cdn.com/flex025/user_avatar/community.homey.app/robertklep/32/160628_2.png) [@robertklep](https://community.homey.app/u/robertklep)\ **Post date:** [June 14, 2023, 7:04pm UTC](https://community.homey.app/t/modding-howto-guide-to-jailbreak-a-homey-pro-2023/81678/10 "2023-06-14T19:04:02Z")
> [@rihanna](#): > > I can find 3 partitions AUTOBOOT/ROOTA/ROOTB Are you sure you mean ROOTA/ROOTB and not **B** OOTA/ **B** OOTB? ---
**Author:** ![Sharkys](https://sea1.discourse-cdn.com/flex025/user_avatar/community.homey.app/sharkys/32/54029_2.png) [@Sharkys](https://community.homey.app/u/Sharkys)\ **Post date:** [June 14, 2023, 7:17pm UTC](https://community.homey.app/t/modding-howto-guide-to-jailbreak-a-homey-pro-2023/81678/11 "2023-06-14T19:17:45Z")
> [@robertklep](#): > > you mean ROOTA/ROOTB and not **B** OOTA/ **B** OOTB? šŸ‘ I was wondering the same, because those 3 basically mounts first by default and then the ROOTA/B and USERā€¦ _Anyway @rihanna , please keep in mind the risks, unless you really know what you are doing šŸ˜‰_ Also avoid submitting any support ticket when jailbreaked, itā€™s clear that any such support request might be and probably will be denied. ---
**Author:** ![robertklep](https://sea1.discourse-cdn.com/flex025/user_avatar/community.homey.app/robertklep/32/160628_2.png) [@robertklep](https://community.homey.app/u/robertklep)\ **Post date:** [June 14, 2023, 7:19pm UTC](https://community.homey.app/t/modding-howto-guide-to-jailbreak-a-homey-pro-2023/81678/12 "2023-06-14T19:19:52Z")
> [@Sharkys](#): > > because those 3 basically mounts first by default and then the ROOTA/B and USERā€¦ AUTOBOOT/BOOTA/BOOTB are all FAT32 partition, which most OSā€™es support out of the box. The others are all ext4, which only Linux supports out of the box. ---
**Author:** ![rihanna](https://sea1.discourse-cdn.com/flex025/user_avatar/community.homey.app/rihanna/32/73733_2.png) [@rihanna](https://community.homey.app/u/rihanna)\ **Post date:** [June 14, 2023, 9:28pm UTC](https://community.homey.app/t/modding-howto-guide-to-jailbreak-a-homey-pro-2023/81678/13 "2023-06-14T21:28:56Z")
You are right. Itā€™s BOOTA/B. I might have some problems with my ext4fuse. ---
**Author:** ![robertklep](https://sea1.discourse-cdn.com/flex025/user_avatar/community.homey.app/robertklep/32/160628_2.png) [@robertklep](https://community.homey.app/u/robertklep)\ **Post date:** [June 15, 2023, 5:03am UTC](https://community.homey.app/t/modding-howto-guide-to-jailbreak-a-homey-pro-2023/81678/14 "2023-06-15T05:03:04Z")
> [@rihanna](#): > > I might have some problems with my ext4fuse. ext4fuse will not automatically mount the ext4 partitions, you have to do that manually. But using ext4fuse will not be able to perform the jailbreak at all, since itā€™s a _read-only_ implementation (@spkesDE). ---
**Author:** ![rihanna](https://sea1.discourse-cdn.com/flex025/user_avatar/community.homey.app/rihanna/32/73733_2.png) [@rihanna](https://community.homey.app/u/rihanna)\ **Post date:** [June 15, 2023, 6:35am UTC](https://community.homey.app/t/modding-howto-guide-to-jailbreak-a-homey-pro-2023/81678/15 "2023-06-15T06:35:25Z")
I tried the Paragon trial and it worked. I got confused as I didnā€™t expect so many partitions and with so similar names. But I have it working now. Thanks. ---
**Author:** ![torarnv](https://sea1.discourse-cdn.com/flex025/user_avatar/community.homey.app/torarnv/32/83065_2.png) [@torarnv](https://community.homey.app/u/torarnv)\ **Post date:** [August 19, 2023, 6:48pm UTC](https://community.homey.app/t/modding-howto-guide-to-jailbreak-a-homey-pro-2023/81678/16 "2023-08-19T18:48:03Z")
Do we know why there are two root partitions? Is one used to restore e.g.? If so, is it safer to modify only the active one, leaving one pristine? Edit: Yeah, looks like it. `/dev/sda6` has a `version` file at the root with `10.0.1`, while `/dev/sda8` has one with `10.0.2` ---
**Author:** ![spkesDE](https://sea1.discourse-cdn.com/flex025/user_avatar/community.homey.app/spkesde/32/54352_2.png) [@spkesDE](https://community.homey.app/u/spkesDE)\ **Post date:** [August 19, 2023, 7:32pm UTC](https://community.homey.app/t/modding-howto-guide-to-jailbreak-a-homey-pro-2023/81678/17 "2023-08-19T19:32:21Z")
> [@The new Homey Pro ā€” Ask Me Anything](https://community.homey.app/t/the-new-homey-pro-ask-me-anything/70378/572): > > So the homey has multiple Partitions 2x Boot ~300mb 2x System ~2,3GB 1x User ~2,7GB In total ~8 GB Why this system? Currently, a Homey update is an image of the boot and system drives. Because you canā€™t write to the currently active partition, there are two boot and system drives, so the currently inactive partition can be updated. They switch the partitions from A to B after the upgrade, and then back to A after the next update. I donā€™t know if they will change the system to a different uā€¦ > [@The new Homey Pro ā€” Ask Me Anything](https://community.homey.app/t/the-new-homey-pro-ask-me-anything/70378/573): > > And this isnā€™t the only reason, the second reason is, if an update fails by for example pulling the plug (which happened more then youā€™ed expect with the old Homey Pros) while updating, it always has a back-up internally it can fall back on. So it is really hard now to brick your system, even when pulling the plug while it is busy updating. (I wouldnā€™t recommend to forcefully try it though wink) ---
**Author:** ![torarnv](https://sea1.discourse-cdn.com/flex025/user_avatar/community.homey.app/torarnv/32/83065_2.png) [@torarnv](https://community.homey.app/u/torarnv)\ **Post date:** [August 19, 2023, 9:38pm UTC](https://community.homey.app/t/modding-howto-guide-to-jailbreak-a-homey-pro-2023/81678/18 "2023-08-19T21:38:17Z")
For macOS, I ran an Ubuntu 22.04 VM in UTM, sharing the Homey USB connection to the VM so I could mount the partitions there. > **[Ubuntu 20.04](https://mac.getutm.app/gallery/ubuntu-20-04)** > > Virtual machines for Mac > **[USB](https://docs.getutm.app/guest-support/sharing/usb/)** > > Documentation for UTM virtual machines ---
**Author:** ![robertklep](https://sea1.discourse-cdn.com/flex025/user_avatar/community.homey.app/robertklep/32/160628_2.png) [@robertklep](https://community.homey.app/u/robertklep)\ **Post date:** [August 20, 2023, 6:38am UTC](https://community.homey.app/t/modding-howto-guide-to-jailbreak-a-homey-pro-2023/81678/19 "2023-08-20T06:38:43Z")
You can also use [extFS for Mac](https://www.paragon-software.com/home/extfs-mac/). Tip: _donā€™t_ set your Macā€™s date to somewhere far in the future before you install it, because then it may extend the trial period to that date instead of just 10 days šŸ˜‰ ---
**Author:** ![Jorg\_Heesbeen](https://sea1.discourse-cdn.com/flex025/user_avatar/community.homey.app/jorg_heesbeen/32/78355_2.png) [@Jorg\_Heesbeen](https://community.homey.app/u/Jorg_Heesbeen)\ **Post date:** [August 23, 2023, 5:03pm UTC](https://community.homey.app/t/modding-howto-guide-to-jailbreak-a-homey-pro-2023/81678/20 "2023-08-23T17:03:23Z")
Can anyone help me, i have done every step. But when iā€™m trying to login, it says connection refused. Homey is on the latest software, 10.0.3 and connected with lan on a fixed local ip adress Experimental SSH is disabled And maked the files executabel Thanks! [Next page](https://community.homey.app/t/modding-howto-guide-to-jailbreak-a-homey-pro-2023/81678.md?page=2)