Back to Home Assistant Guides
Home Assistant

Why Is My Home Assistant Yellow Stuck in a Boot Loop?

Home Assistant GuideSmart Hubs
hard difficulty 45 minutes 116 views 4 found helpful Where this fix applies: Global Updated
This guide applies to: Home Assistant Home Assistant Yellow (All Models)
At a glance — most common causes
  • Corrupted install or interrupted update
  • Failing/incompatible storage (NVMe/eMMC)
  • Underpowered PoE/power supply
45 minutes13 solutions coveredhard level

Expert Review & Technical Scope

DeviceHome Assistant Home Assistant Yellow
Model CoverageAll Models
Fix Time45 minutes
DifficultyHard
Required ToolsUSB drive, Power supply, Computer
Network / ProtocolWi-Fi / app-based troubleshooting context

Problem Description

Your Home Assistant Yellow is stuck in a boot loop — it keeps restarting and never fully loads the dashboard. Boot loops are usually caused by a corrupted SD card, a failed update, or a bad add-on. The LEDs on the Yellow indicate different stages of the boot process. This guide covers identifying the boot loop stage, accessing safe mode, and recovery.

Why This Happens in Real Homes

A Home Assistant Yellow stuck in a boot loop is usually storage, power, or a bad update. The onboard LEDs indicate the boot state, so read them first — then the common culprits are an interrupted update, a failing or unseated NVMe drive, or an underpowered supply that browns out mid-boot.

Start by confirming a solid power source (proper PoE+ or PSU) and reseating the Compute Module and storage, then reflash the OS cleanly if the image is corrupted. A configuration that crashes on start can be fixed via safe mode; persistent looping after a clean reflash points to a hardware fault worth raising with support.

Symptoms

  • Yellow keeps restarting
  • Never loads the dashboard
  • Boot loops on the logo
  • LED pattern shows a fault
  • Stuck booting
  • Fails after an update
  • Will not come online
  • Reboots endlessly

Recognize these? Here's what usually causes it.

Common Causes

  • Corrupted install or interrupted update
  • Failing/incompatible storage (NVMe/eMMC)
  • Underpowered PoE/power supply
  • Compute Module not seated
  • Overheating
  • Bad NVMe image
  • Config causing a crash loop
  • Hardware fault

Most fixes happen in the first 3 steps.

Warning

Do not factory reset your hub unless absolutely necessary as this removes all paired devices, automations, and settings. You will need to re-pair every single device from scratch which can take hours for a large setup. Always try a simple restart first.

Tools & Requirements

USB drivePower supplyComputer
Recommended Tools for Home Assistant Yellow

These tools will help you complete this fix.

As an Amazon Associate we earn from qualifying purchases.

Step-by-Step Solution

1

Identify the boot loop symptoms

The Home Assistant Yellow has LEDs that indicate its boot state. Normal boot: the green LED blinks during startup and turns solid when ready (takes 2-5 minutes). Boot loop: the LEDs cycle repeatedly — the Yellow starts booting, gets partway through, and restarts. This repeats indefinitely. The most common causes: corrupted NVMe drive, bad power supply, corrupt Home Assistant OS image, or failed update that left the system in an inconsistent state.

DC 5V 2A 10W USB Wall Charger with 16.4ft/5M USB C Cable, AC Adapter for Type-C Enabled Home Security Cameras, Power Charging & Power Supply for More USB-C Devices-White

Needed for this step

DC 5V 2A 10W USB Wall Charger with 16.4ft/5M US...

This helps complete the fix you are currently reading.

$11.99
View Needed Item
2

Check the power supply

The Home Assistant Yellow requires the included 12V/2A DC power supply. An underpowered supply causes boot loops — the Yellow starts, the CPU and NVMe draw peak power, and the voltage drops below the threshold, triggering a restart. Check that you are using the original power supply, not a random 12V adapter. Try a different 12V/2A adapter if available. Also check the barrel connector — a loose connection causes intermittent power drops.

3

Reseat the Compute Module and NVMe drive

Power off the Yellow. Open the case (4 screws on the bottom). The Raspberry Pi Compute Module 4 (CM4) sits on a carrier board. Carefully lift the CM4 and reseat it firmly on the connectors. Also check the NVMe SSD — push it down into the M.2 slot and secure the screw. A partially seated CM4 or NVMe causes erratic behavior during boot. Reassemble, reconnect power, and check if the boot loop is resolved.

4

Re-flash the Home Assistant OS

If the boot loop persists: re-flash the OS. Download the latest Home Assistant OS image for the Yellow from the official GitHub releases page. Flash the image to a USB drive using Balena Etcher. Connect the USB drive to the Yellow. Boot from USB — the Yellow's bootloader checks USB first. The installer re-flashes the eMMC on the CM4. After re-flashing, the Yellow boots to a fresh Home Assistant installation. Your data on the NVMe may be preserved (configurations are separate from the OS on eMMC).

5

Restore from a backup

After re-flashing, Home Assistant starts with a clean setup. If you have an automatic backup on a network share, Google Drive (via the add-on), or a local USB drive: during the onboarding process, select 'Restore from Backup' and point to your backup file. This restores your integrations, automations, dashboards, and add-ons. If you do not have a backup: you need to reconfigure everything from scratch. Set up automatic backups immediately after recovery (Settings > System > Backups > schedule a daily or weekly backup).

Quick Solutions

Reflash the Yellow's OS cleanly
Test/replace the NVMe or use eMMC
Use an adequate power source (PoE+/proper PSU)
Reseat the Compute Module
Ensure ventilation/cooling
Re-image the storage
Boot to safe mode to fix a bad config
Contact support for a hardware fault

Still having issues? This is usually the deeper cause below.

If this comes back after following these steps, check whether a recent app or firmware update reset a default setting — the fix works, but the setting gets reverted silently.

Pro Tip

Place your hub in a central location in your home, elevated off the floor and away from your WiFi router by at least 3 feet. This provides the best Zigbee and Z-Wave signal coverage to all corners of your house.

Real-World Insight

Home Assistant issues that only appear after restart are a well-known quirk — triggers that require prior state history simply can't fire until that history rebuilds.

What Usually Goes Wrong
  • Corrupted install or interrupted update
  • Failing/incompatible storage (NVMe/eMMC)
  • Underpowered PoE/power supply
  • Compute Module not seated
  • Overheating
Best Home Assistant Yellow Options

Most popular upgrades chosen by Home Assistant Yellow owners.

As an Amazon Associate we earn from qualifying purchases.

Official Manufacturer Manual

Home Assistant provides official product documentation through their online manual rather than downloadable PDF. Access setup guides, troubleshooting steps, and product specifications for your Home Assistant Yellow.

View Home Assistant Yellow Online Manual

Source: home-assistant.io

Need More Help? Home Assistant Support

Note: The contact information below connects you directly to Home Assistant's official customer support team, not Trunetto. They can help with warranty claims, device replacements, and advanced technical issues.