How to Update Homebrew on Switch Safely

Q: Can I Update My Switch If It Has Homebrew?

Yes, but first confirm that Atmosphère and Hekate support the firmware version you want to install .Do not install a newly released Nintendo firmware simply because the console offers the update. CFW support can arrive later.

Keeping a modded Nintendo Switch updated is not as simple as installing the latest Nintendo firmware. Your Atmosphère custom firmware, Hekate bootloader, Fusee payload, Homebrew Menu, and homebrew apps all need to remain compatible with the Switch system firmware.

If you are searching for how to update homebrew on Switch, the safest approach is to update your custom firmware components first, verify compatibility, and only then consider updating the Nintendo Switch firmware.

As of September 19, 2026, the NH Switch Guide lists Atmosphère 1.11.2 and Hekate 6.5.3 as supporting firmware up to 22.5.0. Nintendo firmware 23.0.0 is not yet supported by that stable combination, so users who depend on CFW should not update to 23.0.0 yet.

Quick Answer: To update homebrew on Nintendo Switch, back up your microSD card, verify that Atmosphère and Hekate support your current or planned firmware, copy the latest Atmosphère files to the SD card, update Fusee and Hekate, update your homebrew apps, and reboot into CFW. Always update Atmosphère and Hekate before installing a newer Switch firmware.

Table of Contents

What You Need Before Updating Homebrew on Switch

Before changing any files, check the versions currently installed on your Nintendo Switch. Most problems after a homebrew update happen because the Switch firmware, Atmosphère version, Hekate version, payload, or sysmodules do not match.

Check Your Switch Firmware Version

Open:

System Settings → System

Your system version will appear under System Update.

If you are running Atmosphèreswitch, the version string can also show information such as:

Nintendo Switch firmware version
AMS for Atmosphère
Atmosphère version
E when using emuMMC
S when using sysMMC/sysCFW

The NH Switch Guide confirms that these indicators can be used to verify whether Atmosphère is running on emuMMC or sysMMC.

Check Atmosphère and Hekate Compatibility

Never assume that the newest Nintendo firmware is immediately compatible with Switch homebrew.

Check the latest release notes for:

Atmosphère
Hekate
Fusee
Your current Nintendo Switch firmware
Important sysmodules or overlays

Atmosphère 1.11.2 currently adds basic support for firmware 22.5.0, while the current stable Hekate release is 6.5.3.

Back Up Your SD Card and Important Files

Before updating, copy your microSD card contents to your computer.

Important folders and files may include:

/atmosphere/
/bootloader/
/switch/
hbmenu.nro
Hekate configuration files
emuMMC configuration
Custom themes
Sysmodules
Payloads

A backup gives you a known working configuration that you can restore if the Switch fails to boot after the update.

How to Update Homebrew on Nintendo Switch

For most users, manually updating the main homebrew components is the safest approach because you can control exactly which files are being replaced.

Step 1: Download the Latest Atmosphère Version

Download Atmosphère from its official GitHub release page.

Read the release notes before installing it because new Nintendo firmware versions can require major changes to Atmosphère.

For example, Atmosphère 1.11.2 specifically requires users to update Fusee when upgrading. The release also bundles hbloader 2.4.5 and hbmenu 3.6.1.

Avoid downloading random preconfigured CFW packages when the official release is available.

Step 2: Update Atmosphère Files on Your SD Card

Connect the Switch microSD card to your PC or expose it through Hekate’s USB storage mode.

Extract the official Atmosphère ZIP.

Copy its contents to the root of the microSD card.

When Windows or your operating system asks whether existing files should be replaced, choose merge/replace.

You normally do not need to completely delete the existing Atmosphère setup first. However, outdated custom sysmodules or manually installed modifications can sometimes cause compatibility problems.

The standard structure should still contain directories such as:

SD Card
├── atmosphere
├── bootloader
├── switch
└── hbmenu.nro

Step 3: Update Fusee Payload

Fusee is the Atmosphère payload used to boot the custom firmware.

When Atmosphère releases a new version, check whether a new fusee.bin is included.

If it is, replace the older Fusee payload wherever you normally store or inject it.

Atmosphère’s official 1.11.2 release explicitly states that Fusee should be updated when upgrading to that release.

Using an outdated payload with a newer Atmosphère installation can cause:

Boot errors
Black screens
Atmosphère startup failures
Payload compatibility errors

Keep the Atmosphère files and Fusee payload from the same release whenever possible.

Step 4: Update Hekate and Nyx

Download the latest official Hekate release.

Extract the archive and copy the:

bootloader

folder to the root of the microSD card.

Merge and replace existing files when prompted.

Do not automatically delete your existing bootloader folder. Hekate’s official update instructions specifically recommend merging the new folder because deleting the existing one may remove your configurations and stored payloads.

Hekate also includes:

bootloader/update.bin

which allows the newer Hekate version to be loaded when appropriate.

If you directly inject Hekate from a PC, phone, dongle, or another device, also update the injected:

hekate_ctcaer_x.x.x.bin

payload.

Step 5: Update the Homebrew Menu

The Nintendo Switch Homebrew Menu, commonly called hbmenu, is the interface used to launch .nro homebrew applications.

Current Atmosphère releases already bundle compatible hbmenu and hbloader files. For example, Atmosphère 1.11.2 bundles hbmenu 3.6.1.

Therefore, if you install the complete official Atmosphère package, a separate hbmenu update is usually unnecessary.

If you manage hbmenu manually, the main file is normally:

/hbmenu.nro

on the root of the SD card.

The latest standalone nx-hbmenu release currently listed by Switchbrew is version 3.6.1.

Step 6: Update Your Homebrew Apps

Individual homebrew applications are separate from Atmosphère and Hekate.

Most Switch homebrew applications are stored inside:

/switch/

and use .nro files.

You can update them manually by downloading the latest version of the application and replacing its old files.

Focus first on apps that interact directly with:

System services
Filesystem
Networking
Overlays
Controllers
Save data
Firmware-specific functions

Older apps may still launch after a firmware update, but applications using outdated libraries or system calls can crash.

Step 7: Reboot and Verify the Update

Safely eject the microSD card or Hekate USB storage connection before rebooting.

Launch your normal CFW configuration through Hekate.

Then open:

System Settings → System

Look for the AMS version string to confirm that the new Atmosphère release is running.

Also test:

Homebrew Menu
Hekate
Important .nro apps
emuMMC
Sysmodules
Tesla overlays, if used
Custom themes

Do not immediately re-enable every modification if you previously disabled them. Test the clean CFW environment first.

How to Update Switch Homebrew Without a PC

Some homebrew applications can be updated directly from the Nintendo Switch, although this approach is better suited to individual apps than the entire CFW stack.

Using the Homebrew App Store

The Homebrew App Store can download and manage open-source homebrew applications directly from hbmenu.

On Switch, the app is normally stored under:

/switch/appstore/

and launched through the Homebrew Menu.

It is useful for maintaining applications such as utilities and homebrew tools without manually moving every .nro file from a PC.

Using a Homebrew Updater

All-in-one updater applications also exist and can download certain CFW components directly to the SD card.

However, automatic updates introduce another dependency into the process. Before using one, verify:

The project’s current maintenance status
The source repository
Which files it replaces
Atmosphère compatibility
Hekate compatibility
Whether it modifies custom configurations

For important CFW updates, manually installing official Atmosphère and Hekate releases provides more control over the update process.

Should You Update Switch Firmware Before or After Homebrew?

Update the compatible homebrew/CFW stack first, then update Nintendo Switch firmware.

This is one of the most important rules when maintaining a homebrewed Switch.

If Nintendo releases a new firmware before Atmosphère and Hekate support it, updating the console can prevent CFW from booting correctly.

Recommended Update Order

A practical update sequence is:

Back up the microSD card
Check firmware compatibility
Update Atmosphère
Update Fusee
Update Hekate/Nyx
Update important homebrew apps
Boot and test CFW
Update Nintendo firmware only when supported
Boot CFW again and verify everything

This minimizes the chance of ending up with a firmware version that your installed CFW cannot boot.

Why Firmware Compatibility Matters

Nintendo firmware updates can change system modules, kernel behavior, application handling, memory management, and other components that Atmosphère interacts with.

A recent example occurred with firmware 22.0.0, where changes to application and applet lifecycle behavior affected the homebrew ecosystem and required Atmosphère changes to maintain compatibility.

That is why a Nintendo firmware update should never be treated like a normal system update on a homebrewed Switch.

Common Problems After Updating Switch Homebrew

Homebrew update problems are usually caused by mismatched versions, outdated files, custom themes, or incompatible sysmodules.

Atmosphère Won’t Boot

If Atmosphère stops booting after an update:

Confirm your Switch firmware is supported.
Verify you installed the latest Atmosphère files.
Update fusee.bin.
Update Hekate.
Temporarily remove third-party sysmodules.
Check the Atmosphère error screen for a program ID or error code.

Old extensions inside the /atmosphere/contents/ directory are frequent causes of post-update crashes.

Homebrew Menu Won’t Open

If hbmenu no longer launches:

Confirm hbmenu.nro exists on the SD root.
Update Atmosphère.
Replace hbmenu with the current release if necessary.
Test both Album/Applet Mode and title override.
Check whether the SD card contains corrupted files.

The Homebrew Menu can normally be launched through Album in Applet Mode or by holding R while launching a title for title override.

Black Screen After Update

A black screen commonly indicates a problem with:

Outdated Hekate
Old Fusee payload
Unsupported firmware
Incorrect boot configuration
Corrupted SD card files
Incompatible sysmodule

Start by testing the newest official Atmosphère and Hekate releases without optional custom modifications.

Hekate or Fusee Errors

If Hekate launches but Atmosphère does not, verify that:

Atmosphère is current.
Fusee matches the Atmosphère release.
Hekate is current.
Your boot configuration points to the correct payload or package.
The target firmware is supported.

Avoid mixing payloads from old CFW installations with newly updated Atmosphère files.

Homebrew Apps Crashing

An app that worked before the update may not yet support the new firmware or current homebrew libraries.

Try:

Updating the application.
Removing its old configuration files only if the developer recommends it.
Checking its release notes.
Disabling incompatible overlays or sysmodules.
Testing the app in a clean Homebrew Menu session.

The current hbmenu release also includes warnings for homebrew using an outdated ABI, which can help identify older applications.

How to Fix a Failed Homebrew Update

If the update fails, avoid repeatedly replacing random files. Restore the system methodically.

Restore Your SD Card Backup

If you created a complete backup before updating, restore the last known working version of:

Atmosphère
Hekate
Payloads
Homebrew apps
Configuration files

Make sure the restored CFW still supports the firmware currently installed on the Switch.

Remove Incompatible Themes or Sysmodules

Themes and sysmodules interact more deeply with the system than ordinary .nro applications.

Temporarily disable custom additions from:

/atmosphere/contents/

Then boot Atmosphère again.

If CFW starts normally, restore the modifications individually after finding versions compatible with the current firmware.

Reinstall Compatible Atmosphère and Hekate Files

If you cannot identify the broken component, reinstall clean copies of:

Latest compatible Atmosphère
Matching Fusee payload
Latest compatible Hekate
Current hbmenu

Keep your personal configuration backed up, but test the core CFW installation before restoring third-party modifications.

Frequently Asked Questions

Can I Update My Switch If It Has Homebrew?

Yes, but first confirm that Atmosphère and Hekate support the firmware version you want to install.Do not install a newly released Nintendo firmware simply because the console offers the update. CFW support can arrive later.

Does Updating Switch Remove Homebrew?

A normal Nintendo firmware update does not simply delete every homebrew file from the microSD card. However, it can make your current Atmosphère, Hekate, payloads, sysmodules, or apps incompatible.That is why compatibility checking is required before updating.

Do I Need to Update Atmosphère Before Switch Firmware?

Yes, when moving to a firmware that requires a newer Atmosphère release, update Atmosphère and the rest of the compatible boot stack first.
The NH Switch Guide specifically recommends checking both Atmosphère and Hekate support before installing system firmware updates

Can I Update Homebrew Without Removing the SD Card?

Yes. Hekate provides USB SD card access, allowing the microSD storage to be mounted on a PC without physically removing the card.

The NH Switch Guide uses:

Hekate → Tools → USB Tools → SD Card

as part of its Atmosphère update procedure.

You can also update some individual homebrew applications through the Homebrew App Store.

Will Updating Homebrew Delete My Games or Save Data?

Updating Atmosphère, Hekate, hbmenu, or normal .nro applications should not delete your games or save data when the update is performed correctly.

Still, create backups before major CFW or firmware updates. Accidental file deletion, SD card corruption, incompatible modifications, or an incorrect configuration can create recovery problems even when the core update itself is designed to preserve user data.

Conclusion: Keep Your Switch Homebrew Updated Safely

Learning how to update homebrew on Switch mainly comes down to keeping the entire CFW environment compatible rather than updating one application.

Start by checking your Nintendo Switch firmware, then update Atmosphère, Fusee, Hekate, hbmenu, and important homebrew apps using trusted official releases. Back up the microSD card before making changes and test the updated CFW before installing a newer Nintendo firmware.

Most importantly, never assume that a newly released Switch firmware already works with homebrew. Verify Atmosphère and Hekate compatibility first. Following the correct update order reduces boot errors, black screens, outdated payload problems, and homebrew app crashes while keeping your Nintendo Switch homebrew setup stable.