Troubleshooting

Common problems during installations can be found here. Before asking for help please review these entries first.

If what you are looking for is not here, feel free to join our help channel on Discord! Please note that this will be updated as time goes on and more and more issues are presented. If you feel like you have a good idea for a contribution send it our way and we'll add it!

Common Issues

My screen is stuck at patching the OS / I am getting error: package2 magic invalid! 

You may get this error when attempting to boot an older version of ReiNX with newer firmwares. In order to resolve this issue, simply update to the latest ReiNX.

Note: If you have ReiNX.bin on your SD card, be sure to either remove it or update it as well.


On 7.0.x I am stuck in a bootloop of just seeing ReiNX and sept / I just see a black screen

You are getting this issue because you have the ReiNX.bin payload on the root of your SD card, causing a chainloading bootloop. To fix this issue, please remove ReiNX.bin from the root of your SD card.

Alternatively it may be due to exFAT issues, in particular corruption or other compatibility issues. Please use FAT32 to ensure everything will work properly.

 

If neither of these solutions have worked, some users have reported that chainloading the ReiNX.bin payload using Hekate has worked. Please perform the following to get this working:

  1. Navigate to the following page and download the latest Hekate.
  2. Copy the hekate_ctcaer_xxx.bin to a safe place to be used in a payload injector.
  3. Copy the bootloader folder to the root of your SD card.
  4. Copy your ReiNX.bin payload to the bootloader/payloads folder.
  5. Boot Hekate as normal, and select ReiNX.bin as your payload of choice to boot.

Homebrew Menu (hbmenu) isn't loading when I open Album

In order for the Album to load the Homebrew Menu, it requires the following:

  • hbmenu.nro must be in your root directory of your SD card.
  • hbl.nsp must be in the ReiNX folder.
    • Alternatively for legacy format Homebrew Loader (hbloader) users, 010000000000100D folder needs to be in the ReiNX/titles/ folder.

Assuming both files are present in the correct locations, the Album will successfully launch the Homebrew Menu.

If the Homebrew Menu still does not load, it may mean your SD card is formatted as exFAT however the Switch does not have the exFAT update.

If this is the case you can do one of the following:

  • Recommended: Format SD card as FAT32, replace files and try again.
  • Install the exFAT system update on your Switch.

Note: For Windows users, you will need the third party utility GUI Format in order to format large SD cards to FAT32.


I can't open the Album when holding the 'R' button, it just opens the Homebrew Menu

Currently hbl.nsp does not support this functionality. Please use the legacy format Homebrew Loader (hbloader) instead by removing hbl.nsp and instead placing the 010000000000100D folder into ReiNX/titles/.

You can find more information on the Step 2 - Download and Install page.


I am on exFAT and I keep having misc. issues

exFAT is prone to corruption, and can cause ReiNX to fail to boot, games to no longer play, homebrew to stop working, etc. We highly recommend formatting your SD card to FAT32.

Note: For Windows users, you will need the third party utility GUI Format in order to format large SD cards to FAT32.


I received an error code from Tinfoil when trying to install an .nsp file

If you are seeing an error code while trying to install an .nsp file with Tinfoil, please refer to Tinfoil error codes section of the following GBAtemp thread.

If your error is not covered there or it still does not resolve your issue, feel free to ask for help in our Discord server linked in the footer.

iPatched Switch

iPatched Switches first started appearing in the wild around June of 2018. The only difference between them and older Switches is that they have patched the hardware based bootom exploit in RCM Mode that all current CFWs rely on. These consoles can still enter RCM Mode, however you will not be able to inject a payload.

How can I tell if my Switch is an iPatched unit?

Looking at the serial number and starting version of the switch can give you a good idea. If your serial number is higher than the listed ones here, there is a good chance your Switch is an iPatched unit.

Versions 4.0.1

XAJ700438XXXXX

Versions 4.1.0

XAJ400541XXXXX

XAJ700445XXXXX

XAW100818XXXXX

XAW700183XXXXX


If you wish to test for sure if you have an iPatched unit, you will need to push a payload using TegraRCMSmash's command line utility here. If you have the GUI version, it is already included.

  1. Ensure that ReiNX.bin and tegrarcmsmash.exe are in the same folder.
  2. While holding Shift, right click in an empty space in File Explorer and you should see one of the following options:
    • "Open Command Prompt Here"
    • "Open PowerShell Here"
  3. Choose either Command Prompt or PowerShell, and input the following command:
    .\TegraRcmSmash.exe -w ReiNX.bin
  4. If it outputs "Smashed the stack with a 0x0000 byte SETUP request!" then the Switch is an iPatched unit.

Archive Bit

Observed Issue

  • Homebrew Menu doesn't show anything.
  • Files or folders just show as 0byte files.
  • Other misc issues where the Switch cannot read a file.

This is somewhat common issue caused by the implementation of Nintendo's filesystem drivers. If a file has the archive attribute enabled (the archive bit), then Horizon OS (Switch OS) will be unable to read it. Fixing it is fairly straightforward, and there are multiple ways to do so.

It is also important to note that modifying the Nintendo folder in any regard will likely cause your games to no longer work requiring you to have to reinstall them.


Windows

  1. Plug your SD card into your computer.
  2. Highlight all folders except the Nintendo folder.
  3. Right click and uncheck the Archive option.
    • Alternatively on older versions of Windows, right click and navigate to Properties > Advanced and uncheck it there instead.

macOS

  1. Plug your SD card into your computer.
  2. Open Terminal.
  3. Execute the following command on each file / folder in your root directory excluding the Nintendo folder:
    sudo chflags -R arch /Volumes/[name of SD card]/[name of file or folder]

Hekate Bootloader

  1. Inject the Hekate bootloader payload.
  2. Navigate to Tools...
  3. Navigate to and select Unset archive bit (all sd files)
    • This may take a while doing it this method