• Home Assistant Yellow
• Ethernet cable

Additionally, make sure you have the following items which are not part of the Kit

• Raspberry Pi Compute Module 5 (CM5)
• USB-C cable
• If you are using PoE, make sure your router or switch provides PoE on that port
• Optional: Power supply (12 V / 2 A, if PoE is not used)
• Flat nose pliers

Preparation steps:

• Make sure you installed Home Assistant Operating System version 14 or later.
• Make sure you have created a backup.
  • Before creating a backup, make sure your CM5 eMMC has enough storage capacity.
  • Check how much disk space you've used under Settings > System > Storage.
  • If this is larger than the eMMC, you need to reduce the size of your instance.

Grounding protects the components from the static electricity that can be naturally present (electrostatic discharge, ESD).

• Always: Touch the working surface before touching electronics.
• Ideally: Use ESD protective equipment, such as ESD table mats and grounding cords.

• Remove the 4 screws on the bottom of the Home Assistant Yellow Kit.
• Keep the thumb screws close by; you will need them again later.

• Make sure the interfaces are facing towards your left.
• Flip the case over.
• Slightly lift off the enclosure on your left.
• Slide the enclosure off towards your right.

• Use the pliers and squeeze the front of the pin so that it fits through the hole.
• Repeat the procedure for the other pin.

• Info: The image shows a Raspberry Pi Compute Module 4. The steps are the same for the Compute Module 5.
• Ideally, the module should be pulled up vertically. But this is hard to do.
• Pull up the module from one side, tilting as little as possible. Tilting can damage the connector.
• This requires quite a bit of force. If it does not work, pull harder.
• Do not use a screw driver as a lever. It might damage the board.

1. Place the board in front of you, the red and blue buttons facing to the right.
2. Orient the CM5: The Raspberri Pi text needs to be on the right hand side.
3. Carefully place the CM5 without force.
   • The CM5 should fall into place slightly when correctly aligned.

1. Press the Compute Module 5 onto the board-to-board connectors until it clicks into place.
   • Make sure you press on both sides (the two long edges).
   • This requires quite a bit of force. If you don't hear a loud click, it is most likely not fully seated.
2. It has been reported that on some boards, there is no click sound when pressing the module onto the board. It can still be seated correctly.
3. Do a visual check to make sure the module is installed correctly: it needs to run parallel to the Home Assistant Yellow board. You can also pull a bit on the sides to make sure it is not loose.
4. Notice: Don't use screws to fix the module in place. The screws can damage the CM5 module.

• Push the 2 plastic push pins into the dedicated hole on the heat sink.
  • Start by first aligning the right plastic push pins into the dedicated hole on the carrier board.
  • Then, place the heat sink onto the module.

1. Take the entire board off your workplace and push the pins firmly through the carrier board.
2. Ensure that the module is still fully seated after securing the heat sink.

• rpiboot is a command line utility for booting a Raspberry Pi in USB device mode. This is needed because the CM5 cannot boot from the USB 2.0 ports of the Yellow.
• Install rpiboot on your PC.
  • Windows: Download and run the Windows Installer from Raspberry Pi Github.
  • MacOS or Linux: Install from source code.
  • Install rpiboot, but do not run it yet!

1. On the Yellow board, make sure the JP1 jumper is set to USB.
   • It is there by default, but it is worth to double-check.
2. Plug-in a USB-C cable to Home Assistant Yellow and connect it to your PC.
   • Make sure the cable supports USB 2.0 data.

1. On the Yellow board, press and hold the recovery button.
   • Older Home Assistant Yellow versions: Bridge JP2 (USB-C Rcvry).
2. Power up the board.
   • Only the red LED should be on at this point (solid, not blinking).
3. Release the recovery push button.
   • Older Home Assistant Yellow versions: Un-bridge JP2.

• On your PC, run rpiboot and let it run through.
  • If you are using Windows, it might ask you if you want to reformat the disk. Select Cancel each time.
  • If you are running an Apple Silicon mac, before running rpiboot, make sure you open the terminal using the “Rosetta” compatibility mode.
  • If you are using Linux or MacOS, use sudo ./rpiboot -d mass-storage-gadget64 to run the tool.
• After a few seconds, the yellow LED on the Yellow board should start blinking.
• Afterwards, only the green LED should be on.
• The module is now ready to have the Home Assistant Operating System installed on it (next steps).

• Install the Raspberry Pi Imager on your computer as described under https://www.raspberrypi.com/software/
• If your platform doesn't support the Raspberry Pi Imager, you can use another imager (e.g. balenaEtcher) and flash the Home Assistant OS Installer for Yellow directly from GitHub releases.

• Open Raspberry Pi Imager.
• Under Raspberry Pi Device, select Raspberry Pi 5.

• Select Choose OS
• Choose Other specific-purpose OS.
• Choose Home assistants and home automation.
• Choose Home Assistant.
• Choose Home Assistant OS x.y (Yellow).

• Select Choose storage and from the dropdown menu, select your Raspberry Pi module.

1. Select the Next button to start the process.
2. Wait for the Home Assistant OS Installer to be written to the internal eMMC storage on your module.
3. Follow the wizard.
4. When the steps are complete, close the rpi-installer.

1. Unplug the USB cable.
2. Unplug the power cable.
3. Set the JP1 jumper to UART.

• Place the translucent bottom part of the case onto the table.
• Make sure the two round notches form a line pointing towards the top right corner.

• Place the board onto the bottom part of the case.
• Make sure the USB connectors are facing upwards, away from you.

• Turn the enclosure upside down.
• Then, slide the push buttons into the openings of the case.

• Insert the 4 thumb screws.
• Do not over-tighten the screws.

• Connect Ethernet and power.
• Start up may take a while. Once the yellow LED blinks in a heartbeat pattern, the system is up and running.

1. Open Home Assistant:
   • Mobile: Confirm the IP address detected by the app. E.g. http://192.168.1.196:8123
   • Desktop: Visit http://homeassistant.local:8123 to access the Home Assistant frontend.
2. On the onboarding screen, select Restore from backup.
3. For more information, refer to the section on restoring from backup.