• Home Assistant Yellow
• Heat sink assembly bag
• Ethernet cable
• Power supply (12 V / 2 A) (Not included if you have a PoE kit)

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

• Raspberry Pi Compute Module 4 (CM4)
• USB flash drive
• Optional: NVMe M.2 SSD drive
• No. 1 hex screwdriver

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

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

• Make sure you have all the components:
  • 1 Raspberry Pi Compute Module 4 (CM4)
  • 1 heat sink
  • 2 thermal pads
  • 2 push pins

1. Place the board in front of you, the connectors facing to the right.
2. Orient the CM4: The CE mark needs to be on the bottom.
3. Use the outline of the chips to help find the correct orientation of the CM4.
   • Note: On CM4 Lite variants, the chips on the bottom edge are in a different location.
4. Carefully place the CM4 without force.
   • The CM4 should fall into place slightly when correctly aligned.

• Press the CM4 board onto the board-to-board connectors until it clicks into place.
  1. 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. Do a visual check to make sure the CM4 is installed correctly.
     • It needs to run parallel to the Home Assistant Yellow board.

1. Remove the protective cover from one side of the square thermal pad.
2. Stick the unprotected side onto the SOC (the silver square next to the raspberry icon).
3. Remove the protective cover from the top side of the thermal pad.
4. Repeat the steps with the rectangular thermal pad. Place it on the memory (the black rectangle next to the SOC).

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

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

• Unscrew the stand-off nut.

• Carefully hold the NVMe M.2 SSD by the long sides.
• Align the notches in the SSD with the ridges in the slot.
• Then, insert at a ~30-degree angle.
• Do not force the connection.

• Slide the stand-off nut into the dent at the end of the SSD drive.
• Make sure the thinner end of the nut is on top.

• Press the stand-off nut and the SSD drive against the board.
• While pressing down the drive, turn over the board.
• From the rear side of the board, insert the M2 hex screw.

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

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

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

• Insert the 4 thumb screws.

• Install the Raspberry Pi Imager on your computer as described under https://www.raspberrypi.com/software/.
  • Info: 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.
  • Important: If you are using a Raspberry Pi Compute Module 4 (CM4) that already has software on it, this procedure does not work. Ignore this and the following steps.
    • Instead, follow the procedure Option 2: Reinstall Home Assistant OS using rpiboot.
    • The reason is that by default, the CM4 tries to boot from the internal eMMC before booting from the USB flash drive.

• Under Raspberry Pi Device, select Raspberry Pi 4.

• Select Choose OS.
• Choose Other specific-purpose OS.
• Choose Home assistants and home automation.
• Choose Home Assistant.
• Choose Home Assistant OS Installer for Yellow.

• Insert the USB flash drive into the computer. Note: The contents of this drive will be overwritten.
• From the dropdown menu, select your USB flash drive.

• Select the Next button to start the process.
• Wait for the Home Assistant OS Installer to be written to the USB flash drive.
• Eject the USB flash drive.

• Insert the USB flash drive with the Home Assistant OS Installer into your Home Assistant Yellow Kit.

• Connect the Ethernet cable to your Home Assistant Yellow Kit and make sure it has access to the internet.
  • Note: Internet is required because the newly installed Home Assistant OS does not contain all Home Assistant components yet. It downloads the latest version of Home Assistant Core on first start.

• If you are not using PoE, connect the power supply to Home Assistant Yellow Kit.
• Info: For CM4 Lite, Home Assistant OS is automatically installed on the NVMe SSD. For regular CM4s, Home Assistant OS is installed onto the eMMC by default.
• Advanced: Forcing installation onto the NVMe SSD when using CM4 with eMMC:
  • Press the blue button while the yellow LED is on constantly (during the 5s window, see next step).

• Wait for Home Assistant Yellow to start booting from the USB flash drive.
• During boot, the Yellow LED will blink steadily.
• Once the installer is ready, the Yellow LED will be constantly on for 5 seconds.
• Troubleshooting: If the LED is stuck in steady blinking or constantly on for an extended period of time, this could indicate that the installer cannot connect to the internet. Follow this procedure to troubleshoot.

• During installation, the LED will blink fast.
• Wait for Home Assistant Yellow to finish installing the Home Assistant Operating System.
• Once the installer finishes installing the Home Assistant Operating System, only the red LED will be on.

• Remove the USB flash drive.
• Remove the power cable.

• Reinsert the Ethernet cable.
• Reinsert the power cable to start Home Assistant (if PoE is not used).

1. Initial startup may take a while, depending on your internet connection.

2. Install the app.

To access Home Assistant from your mobile device, use the QR code to locate the app in the app store.

3. Select your Home Assistant server.

   Mobile: Confirm the IP address detected by the app. For example http://192.168.1.196:8123

   Desktop: Visit http://homeassistant.local:8123 to access the Home Assistant user interface.

4. The Home Assistant user interface guides you through the initial onboarding.

5. For further information, refer to the instructions provided under https://www.home-assistant.io/getting-started/onboarding/.

• CM4 or CM5 Lite: If you have a Raspberry Compute Module 4 Lite: As there is no eMMC flash, you can skip this and the following steps.

• Regular CM4 or CM5 modules: This moving your data procedure is required for making use of your SSD, even if your module is new.

• In Home Assistant, go to Configuration > System > Storage

• Select Move datadisk.

• Select your NVMe drive. If it does not show the full name of your disk, select nvme0n1 and select MOVE.
• Info: For a small instance of 5 GB (incl. 6 add-ons) this takes about 5 minutes.
  • Depending on the size of your instance, this may take 30 minutes or longer.

• Once the transfer has been completed, hover over the status bar to see how much free disk space there is available.
• Note that the eMMC section has disappeared.