Illustrated installation booklet
Nintendo Switch 2
Experimental alpha Checked for Alpha 3 · v0.9.0-switch2-alpha.3
This is an early test version (an alpha). Bugs can interrupt play. Tick each checkpoint as you go; your ticks stay on this device.
01 / 17 · Nintendo Switch 2
Before you start
- Check the console’s name. This booklet is for Nintendo Switch 2. If your console is an original Switch, Switch Lite, or Switch OLED, use the other booklet.
- Check that homebrew already works: A compatible native homebrew setup. Native means made for Switch 2. It must already open the native Homebrew Menu.
- If homebrew is new to you, start with kaiHEN’s official instructions. Finish that setup before coming back here. The Sonic Riders installer does not set up homebrew.
- The recorded console test used firmware 23.0.1, kaiHEN 20261117.1 through Seedsow, and OunceShell. This is one tested setup, not a promise for every console. The Seedsow project’s setup instructions describe that entry route and its extra requirements. Do not update firmware just to match these numbers. Check those projects’ current compatibility instructions.
- Use a 64-bit Windows 10 (1803 or newer) or Windows 11 computer. Connect it to the internet. Windows 11 is recommended. A Mac, phone, or Chromebook cannot run this Windows installer.
- Make at least 8 GB of free space on the computer. Extra room is helpful if your disc needs converting.
- Have the SD card already used by your working Switch 2 homebrew setup. Leave at least 2 GB free, plus room for any texture packs. Have a reader that can read that card, including microSD Express if that is what your setup uses.
- Have your own Sonic Riders for GameCube, USA, revision 0 disc image. The next page explains this file.
- Keep the computer awake and plugged in while it builds. Allow 10–40 minutes for a first install. Download speed and computer speed can change this time.
02 / 17 · Nintendo Switch 2
Prepare your game image
- Find your own USA GameCube Sonic Riders disc. This is the original Sonic Riders, not Sonic Riders: Zero Gravity.
- A disc image is one file holding a copy of a disc. A full image usually ends in
.iso. Copying a disc to this file is called dumping. - If you need to dump it, open the illustrated Wii dumping walkthrough. It uses CleanRip, a disc-copying homebrew app. Follow its GameCube section. You need a Wii that can read GameCube discs and a working Homebrew Channel. The Wii mini, ordinary Wii Family Edition, and Wii U’s Wii mode cannot read these discs.
- Let CleanRip finish. Copy the resulting full
.isofrom its storage device to a folder on your computer. Keep the original file safe. Follow the dumping guide’s file-joining instructions if your dump is split into parts. - Already have a dump? You can select a clean
.isoor.gcm. A clean Dolphin.rvzor.wiaalso works. The installer converts it to.isofor you. Your original file stays unchanged. - Use a clean, full copy. European, Japanese, modified, trimmed, incomplete, GCZ, and CISO images are not accepted. An RVZ made with Remove Junk Data is not a full copy. Renaming a file cannot turn it into the right game.
Optional details for a helper
For helpers: accepted disc ID GXEE8P, revision 0; full ISO size 1,459,978,240 bytes; SHA-1 ce0cecf57034bef8bab7d6f588ce92c85a849613. The installer checks this fingerprint automatically. A filename alone does not prove that a dump is supported.
03 / 17 · Nintendo Switch 2
Download the correct setup package
- Open the Nintendo Switch 2 release page. GitHub is the website that holds this project’s downloads. You can read the page and download without an account.
- Check the heading. This page should say Switch 2 Alpha 3. The Pre-release label is expected. Alpha means it is still being tested.
- Scroll down to Assets. Assets means the downloadable files. If the list is folded up, click Assets to open it.
- Click
SonicRiders-Switch2-Setup-Alpha3.zip. You can also use the big download button below. - Wait for the download to finish. Do not choose Source code (zip) or Source code (tar.gz). Those are for developers and do not contain the ready-to-use Windows installer.
04 / 17 · Nintendo Switch 2
Extract the ZIP file
- Open File Explorer. It is the yellow folder app on the Windows taskbar, at the bottom of the screen.
- Click Downloads in the left column. Find
SonicRiders-Switch2-Setup-Alpha3.zip. If you chose a different download location, open that folder instead. - Click the ZIP with the right mouse button. Choose Extract All…. A ZIP stores several files in one file. Extracting restores those files to a normal folder.
- In the extraction window, choose a short place you can find again, such as
C:\SonicRidersAlpha. Use English letters and numbers in the path. Spaces work, but accented characters in the path can stop the tools. - Click Extract. Wait until it finishes. Keep all the extracted files together.
- Open the extracted folder. Open
SonicRiders-Switch2-Alpha3if there is one more folder inside. Stop when you can seeInstall Sonic Riders (Switch2).exe,setup, andtoolstogether.
05 / 17 · Nintendo Switch 2
Connect the SD card
- Quit any running game. Power the console fully off using its power menu. Sleep mode is not power off. Follow your homebrew setup’s shutdown instructions.
- Remove the prepared SD card. Put it in your computer’s card reader. If your computer has no matching slot, use a suitable USB reader.
- Open File Explorer. Click This PC in the left column. Look for the card under Devices and drives. A drive is a storage device shown by Windows.
- Open the card. Its root means its very top folder. You should be looking at the existing
switchfolder, alongside your other homebrew files. Do not openswitchyet. - If a working homebrew card has no
switchfolder yet, make one at this top level: right-click an empty space, choose New → Folder, and type exactlyswitch. Leave the other folders alone. - If Windows asks you to format the card, click Cancel. Formatting erases files. Check that the reader supports the card and that it is the right card.
06 / 17 · Nintendo Switch 2
Open the installer

- Go back to the normal folder you extracted on your computer.
- Double-click
Install Sonic Riders (Switch2).exe. Double-click means press the left mouse button twice quickly. - Windows may hide the
.exeending. In that case, look for the same name with Application in the Type column. Do not open the command-line BAT file for this illustrated guide. - Check the installer window. It should identify Switch 2 Alpha installer.
- If Windows blocks the program, first check that the ZIP came from the exact project release linked above. This installer is unsigned. If you cannot verify the download, stop and ask someone you trust to help. Do not turn off Windows security.
07 / 17 · Nintendo Switch 2
Select your game image

- Click the pink-marked Select disc… button shown in the picture.
- In the file window, open the folder where you saved your own game dump. Single-click the
.iso,.gcm,.rvz, or.wiafile. - Click Open. This selects the file for the installer. You do not need to double-click or mount an ISO in Windows.
- Look below Select disc…. Your selected file’s name should now appear. The installer performs the full game checks when you start the build.
08 / 17 · Nintendo Switch 2
Select the SD card

- Find 2. SD CARD in the installer.
- Click Refresh if you inserted the card after opening the installer.
- Click the small downward arrow on the SD card box. Choose your card if it is listed.
- If your card is missing from that list, click Other…. In the folder picker, choose This PC, then your SD card’s top folder. Click the folder picker’s confirmation button. Do not choose the folder holding the installer.
- Check that the card you picked is the same card you opened in the previous page. For a first install, keep Copy the disc image too ticked. This puts the game’s data beside the program.
- If you want to copy files later, choose Keep SD-ready files on this PC instead. This makes files on the computer only. Use the manual-copy page below afterward.
09 / 17 · Nintendo Switch 2
Configure installation options

- Find 3. SHADER COMPILER LICENSE. Click Read shader compiler license. Read the terms before deciding.
- If you agree, tick I accept the Android SDK License. This is needed for a tool that prepares the graphics. It does not install an Android game on your console.
- The compiler download is about 1 GB, in addition to other tools. Leave the computer online.
- 4. GAME ICON uses the project’s game icon. There is no icon file to choose here.
10 / 17 · Nintendo Switch 2
Build and install
- Click BUILD AND INSTALL at the bottom right. If it is dimmed, read the message at the bottom. It tells you which required choice is missing.
- Leave the installer open. It checks your image, downloads its tools, and builds the program from your own disc. Build means make the program that your console can run.
- Watch the progress messages. Some steps take several minutes. A changing log is a sign that it is working. Keep the internet connected and the SD card plugged in.
- Do not press Stop unless you want to cancel. Do not close the window, unplug the card, or put the computer to sleep while files are being written.
- Wait for Done or INSTALLATION COMPLETE. If you see INSTALL FAILED, go to the help section. Having a folder named
builddoes not by itself mean the build succeeded.
11 / 17 · Nintendo Switch 2
Open the output folder

- After success, click Open Output Folder in the bottom action bar. The button stays there when you resize the window.
- File Explorer opens a folder on your computer:
build/switch2/sd/switch/sonicriders-switch2/. It opens this local folder even if you already disconnected the SD card. - Look for
sonicriders-switch2.nro,build-info.json,env.txt, andsettings.ini. The.nrois the console app. The JSON file identifies the matching build. The two text files hold startup defaults and settings. - If the installer already copied to the correct SD card and reported success, continue to Verify the SD card folder structure. Opening this folder does not copy anything by itself.
12 / 17 · Nintendo Switch 2
Copy the files manually
- Use this page only if the installer did not copy to your SD card. Keep the installer’s successful output folder open.
- Open a second File Explorer window. Open This PC, then your SD card.
- Open the card’s
switchfolder. Ifsonicriders-switch2is missing inside it, right-click an empty space, choose New → Folder, and name it exactlysonicriders-switch2. - In the local output folder, select
sonicriders-switch2.nro,build-info.json,env.txt, andsettings.inifor a fresh install. Hold Ctrl while clicking each file. Press Ctrl+C to copy. - Open
/switch/sonicriders-switch2/on the card. Press Ctrl+V to paste. Wait for the copy to finish. - Copy your own full ISO or GCM into that same folder. An RVZ or WIA cannot be used directly on the console. If the installer converted one, use the generated
.isofrom the extracted installer’sbaseromfolder. - Keep just one supported game image in this game folder. Its name may differ from the example. It must really end in
.isoor.gcm, not.rvz,.zip, or.iso.iso.
13 / 17 · Nintendo Switch 2
Verify the SD card folder structure
- On the card, open
switch, thensonicriders-switch2. Compare it with the picture below. - Check the exact app name:
sonicriders-switch2.nro. Do not rename another platform’s app to this name. - Check that your own full
.isoor.gcmis in the same folder as the NRO. The example usesSonicRiders.iso; the installer keeps your ISO’s original name. - If Windows hides file endings, use View → Show → File name extensions on Windows 11. On Windows 10, open View and tick File name extensions. Now check that the app does not end in
.nro.nro. - Leave your other homebrew folders alone. This picture shows only the part that matters to Sonic Riders.
The files needed to start
SD card (top folder)
└── switch/
└── sonicriders-switch2/
├── sonicriders-switch2.nro
├── build-info.json
├── env.txt
├── settings.ini
└── SonicRiders.iso ← your full image; its name may differ
After playing or adding packs, you may also see
/switch/sonicriders-switch2/ ├── saves/ ← your game progress; keep this ├── settings.ini ← your choices; keep this ├── mods/ ← texture packs/mods, if added; keep this └── cache files ← may appear after playing; keep theseNext page
14 / 17 · Nintendo Switch 2
Safely eject the SD card
- Wait for all copy windows to finish. Close any files or Explorer windows using the card.
- If the installer has your SD card selected, click Eject SD card. Wait for Safe to remove the SD card now.
- Or use Windows: click the small up arrow near the clock at the bottom right. Right-click Safely Remove Hardware and Eject Media. Choose Eject for your card or reader.
- Wait for Windows to say the hardware can be removed. If it says the card is in use, close the program using it and try again. Do not pull it out during a copy.
- Take the card out of the reader. With the console fully powered off, put the card back in it. Start your usual working homebrew setup.
15 / 17 · Nintendo Switch 2
Launch Sonic Riders
- Start your already-configured native Switch 2 homebrew environment.
- On HOME, highlight a native Switch 2 game that your loader supports. Hold the controller’s R shoulder button while opening it. Keep holding R until the native Homebrew Menu opens.
- Follow the current loader instructions if the first launch still opens the game. kaiHEN’s instructions say the second launch and later open hbmenu. Close the native game normally and repeat the hold-R launch when instructed.
- In Homebrew Menu, use the stick or D-pad to highlight Sonic Riders. Press A.
- Wait for the game to start. You should reach the intro or title screen. Follow the game’s on-screen prompts. It may ask to create a memory-card save on the first run.
- When you reach the main menu, you have completed the install. Try a short race before adding optional packs or changing many settings.
16 / 17 · Nintendo Switch 2
Verify the installed version
- In the game, hold Minus (−) for about half a second. This opens the port’s settings menu.
- Open About. Check the version/build information against Alpha 3 · v0.9.0-switch2-alpha.3. If an old version is still shown, follow Update without losing your progress below.
- Keep normal 60 FPS selected for a first test. Unlimited rendering is experimental. The number 60 is a target, not a guarantee for every scene or setup.
- To quit normally, open the Minus menu, choose Quit Game, and confirm. Wait to return to Homebrew Menu. Do not remove the SD card while the game is saving.
17 / 17 · Nintendo Switch 2
Update without losing your progress
- Quit Sonic Riders normally before you update. Connect the SD card to your computer using the same safe steps as before.
- Back up first. Copy the whole
/switch/sonicriders-switch2/folder from the SD card to a safe folder on your computer. A backup is a spare copy. Keep it until you know the update works. - Open the Nintendo Switch 2 release page. For a future update, check for a newer release for this same platform. Download its matching setup ZIP.
- Extract the new ZIP to a new normal folder on the PC. Open its installer. Select your same own game image and the same SD card root.
- Build and install. Keep the existing full game image if it is already verified on the card; Copy the disc image too can be unticked for that case.
- For a manual update, copy only the new
sonicriders-switch2.nroand its matchingbuild-info.jsoninto the existing game folder. Replace that pair together. Do not overwrite your SD card’senv.txtorsettings.iniwith fresh defaults. - Keep
saves/,settings.ini,mods/,env.txtif present, and cache files. Your texture packs live undermods/. Do not delete the old game folder or replace it with an empty folder. - Eject safely. Launch again. Open Minus → About to check the version/build. Also check that your save and chosen settings are still there.
Troubleshooting
Something looks wrong?
Find the sentence that sounds like your problem and open it.
My download does not contain the right installer
Check the full ZIP name: SonicRiders-Switch2-Setup-Alpha3.zip. Open the release page and choose that asset. Source code (zip) is not the setup package. Keep all extracted files together.
The installer cannot find setup files
Close it. Right-click the original ZIP and choose Extract All…. Open the normal extracted folder. The EXE, setup, and tools must be together. Do not run a lone EXE copied out of the ZIP.
It says the game image is wrong
Read the exact message. Only the clean USA GameCube disc, revision 0, is supported. Select the full correct dump. For a checksum or incomplete-copy error, dump your own disc again using CleanRip’s checks. A different filename cannot fix different contents. RVZ/WIA must preserve the original disc data. See the full-image fingerprint on the disc page.
Back to that page’s stepsThe app or disc file is missing
Wait for a successful build first. Open the output folder and copy sonicriders-switch2.nro to /switch/sonicriders-switch2/. Put your full ISO/GCM beside it. Show file name extensions to catch .nro.nro or .iso.iso. RVZ stays on the PC; copy the converted ISO from baserom instead. Also copy the matching build-info.json.
My folders look different
The card needs /switch/sonicriders-switch2/sonicriders-switch2.nro. An extra switch inside switch is wrong. So is copying the Windows setup folder to the card. Open the correct destination and copy only the files shown in the finished-tree picture. Preserve the other apps already on the card.
Sonic Riders is not in Homebrew Menu
Check that you are using the correct platform’s working Homebrew Menu. Check for sonicriders-switch2.nro directly in /switch/sonicriders-switch2/. Eject safely after correcting the files, then reopen the menu. A ZIP or Windows EXE will not appear as a console app.
The SD card is not found
Check that File Explorer can open the card. In the installer, press Refresh, then try Other… and pick its top folder. If Windows asks to format it, cancel. Check the reader and your existing homebrew setup before continuing.
Back to that page’s stepsThe installer says INSTALL FAILED
Keep the window open and read the last error. Find setup.log beside the installer EXE. If it reports insufficient space, free the stated space. If it reports a download failure, restore your connection and retry. If it reports unsupported path characters, extract to the short English-letter PC folder shown earlier. If a hash check fails, do not bypass it. Save the log and report the error if retrying does not fix it.
I get a black screen or a crash
Check the native Switch 2 package, native Homebrew Menu, full ISO/GCM, and exact folder first. Do not use the original Switch NRO or rename it. If those match, preserve the logs and report it. Alpha compatibility is limited; there is no verified universal black-screen fix.
Back to that page’s stepsKnown problems that are still open
Fixed in Alpha 3: the Race Select audio distortion of Alpha 2 no longer happens in our tests. Open: Super Sonic flight is experimental and off by default (after an air trick he can stay on his board until your next move). This is still an alpha: report anything odd with your log.
Back to that page’s stepsAbout still shows the old version
Compare the new local NRO with the file in /switch/sonicriders-switch2/. Make sure you copied to the card you actually use. Follow the manual update route, then launch that app again and check Minus → About. Keep your backup and save. If the version remains old, report both the downloaded ZIP name and the displayed version. Do not assume this identifies the cause of issue #31.
Bug reports
Report a problem
- For an installer problem, open the normal extracted setup folder. Find
setup.logbeside the installer EXE. Open it in Notepad. Save a copy before retrying. - For a console problem, quit normally if possible. Before launching again, copy
sonicriders.logandsonicriders.prev.log, if present, from/switch/sonicriders-switch2/to the computer. Also keeplifecycle-*.logfiles if present. The*stands for the different numbers in their names. - Read the copies before sharing. Replace personal paths, names, IP addresses or other private details with
[removed]. Do not remove the error messages. - Open the bug report form. A free GitHub account is needed to post a report. Reading guides and downloading do not need one.
- Write Nintendo Switch 2, the ZIP filename, version/build shown in About, console model, firmware, homebrew loader/version, and exactly what you clicked or played. Say handheld or docked, stage, character, gear, player count, settings and any known clock settings. If you do not know a number, say “unknown”.
- Add the error text and the cleaned log copies. Say what you expected, what happened, and whether you can make it happen again. A cropped photo of the error can help; hide private details.
- Never attach your ISO/RVZ, NRO, saves, console keys, passwords, generated code or game assets. Those are not needed for a useful public report.
Bug report template
Platform: Nintendo Switch 2 Setup ZIP: SonicRiders-Switch2-Setup-Alpha3.zip Version/build in About: … Firmware and homebrew loader/version: … Handheld or docked; known clocks: … What I did, one step at a time: … What I expected: … What happened / exact error: … Does it happen again? … Cleaned log copies attached: …
Finish line
Installation complete
Keep your backup until you have confirmed that the game works. Come back to this booklet when updating or troubleshooting.
Sources and what was checked
The published ZIPs were downloaded and hash-checked, and their installers were run on Windows into disposable SD folders. The real installer captures come from those published programs. Console steps use the project’s hardware reports and the linked homebrew instructions. Drawn console screens are marked as illustrations.