Currently we have up to three procedures, e.g. for Kit with NVMe:

1. Install the Raspberry Pi CM4 Module
2. Install NVMe drive
3. Reassemble your Home Assistant Yellow
4. Installing Home Assistant Software on Kit

That makes it awkward to have all the tools required part of the first procedure (also, it is wrong depending on the options selected).

Add a Required Tools thingy at the very top, outside of any procedure.

Setting up the hardware

• Step 1: I grabbed a screwdriver while I didn’t need it. Add Optional before the text.
• Step 2: A lot of people won’t do this.
• Step 3: Removing the protective cover isn’t a step, maybe at the end? In the picture, you don’t see it, while it’s maybe wise to keep it till the end.
• Step 3: I only removed the top part of the case. Should I also remove the bottom?
• Step 5: CM4 click into place, make sure you do both.
• Step 5: “The berry icon needs to be upside down” is nice, maybe start with that. Now I didn’t read it and just figured it out by myself.
• Step 6: My heat pad was a bit smaller. Add a hint that this shouldn’t be a problem, right?
• Step 6: Give a hint to remove both protective covers off the heat pad. People can be stupid.
• Step 7: Installing the heat sink can be tricky in my experience. I would recommend pushing the pins in the heat sink before pushing them into the Yellow.
• Step 12: how to know what the extrusion is?
• Step 17: On PoE, you don’t have HA installed yet?

Installing Home Assistant Software on Kit

• Step 10: Add PoE description
• Step 13: Why do I need to press the red or blue button?

Landing Page

Should not land on a guide
Land on a way to choose the correct guide

On my Raspberry Pi Imager 1.8.1 (installed through Flathub), there is now a selector for "Raspberry Pi device". (I've selected something, but there is no default.)

It would be great if the FAQ explained which CM4 SKUs one should use in what scenarios and if there any known issues with specific configurations.

For example:

1. When using a Lite SKU, you will also need to have an SSD and follow these setup steps (add a link)
2. If using lower RAM SKUs you should take the following into consideration... (Runs on 1GB yeah sure, but what RAM is recommended, or is required in certain scenarios like ESPHOME)
3. Do you need WI-FI? Will the WI-FI even be used if you have it?

I notice some of this is on the how to find a CM4 page... but in the FAQ would be better.

Split no LED and red LED only. In the No LED case, add a side view and really put focus on alignment and check.

The Home Assisntant Yellow (with CM4) problem is solved, so the focus should be for Kit users (which seem to struggle as well).

On CM4 installation, add a step with alignment between Step 1 and Step 2.

Despite clear text above the list, some people interpret the list as known working... Let's use a red font to alert people that this is a negative list.

We should warn about ESD, even if people don't read it. It can also be about liability...

I suggest some improvements:

• Use ESD logo https://de.m.wikipedia.org/wiki/Datei:ESD_%28Protected%29.svg

Change hint to:

• Always: Touch working surface before touching electronics. This protects the components from the static electricity that can be naturally present.
• Ideally: Use ESD protective equipment such as ESD table mats and grounding cords.

On the "Getting Started Home Assistant Yellow Kit with NVMe" (https://yellow.home-assistant.io/power-supply-nvme/), in section "Installing the NVMe drive" in "Step 2 Inserting the drive" the 2nd paragraph read "Carefully hold the NMVe M.2 SSD by the sides.", rather than "Carefully hold the NVMe M.2 SSD by the sides."

I would like to work on this issue. Can you please assign me this issue?

Thicker Square one goes here

Thinner Rectangular one goes here

I would like to work on this issue. Can you please assign me this issue?

Not sure if you guys are on the lookout for issues, but this seems to be a bit of a show stopper fr people who have just received their POE kits in the past couple of weeks (me included :( ).I would rather do it in a supported way rather than dropping out to the terminal.

https://community.home-assistant.io/t/unable-to-move-datadisk-to-nvme-on-yellow-poe-kit/553508

The problem

The Radio LED is referenced in src/hardware/yellow-v1.3-poe.html (https://yellow.home-assistant.io/hardware/yellow-v1.3-poe/) but its behavior is not documented in src/guides/yellow-leds.html (https://yellow.home-assistant.io/guides/yellow-leds/).

Please, could some information be written in the appropriate page?

Link to the page

• https://github.com/home-assistant/yellow.home-assistant.io/blob/16ae2a397c1b7f262b7fb967335e56cb997a0251/src/guides/yellow-leds.html
• https://yellow.home-assistant.io/hardware/yellow-v1.3-poe/
• https://github.com/home-assistant/yellow.home-assistant.io/blob/16ae2a397c1b7f262b7fb967335e56cb997a0251/src/hardware/yellow-v1.3-poe.html
• https://yellow.home-assistant.io/guides/yellow-leds/

Paulus: can we change getting started screenshot to show onboarding ?

• Add USB stick
• Step 3, typo in Raspberry Pi Imager

Originally posted by @agners in #2 (comment)

• Step 2 Push the Ethernet cable into the jack until you hear a click change it to Plug in your Ethernet cable and make sure it is locked into place
• Step 4 Once your Home Assistant Yellow has initialized, ... change it to Once your Home Assistant Yellow is finished downloading, ...

Please provide a link to, for example, https://github.com/NabuCasa/yellow-buildroot/releases so those who don't have a supported OS for rpi-imager may find the files and manually flash their install media.

Background, I use Fedora at home. Outside of forcing the package with alien, I can't install rpi-imager because it only provides packages for Ubuntu, Windows, and Mac. The only install instructions on the yellow.home-assistant.io site point to finding the images in rpi-imager.

Instead of resizing/optimizing images locally, make use of 11ty's image processing feature:
https://www.11ty.dev/docs/plugins/image/

Just got my yellow, CM4 with 32GB eMMC (CM4108032) and Kingsman KM600 128GB NVMe installed
Boot up with USB installer and waited for yellow light up constantly. Press the blue button.
After onboarding, everything still install on eMMC in cm4, 128GB NVMc can only be a data disk.
Any idea which step was wrong ?

I would like to work on this issue. Can you please assign me this issue?

Review the LEDs descriptions