From linux-wiiu Wiki
Revision as of 06:59, 22 August 2022 by Quarky (talk | contribs) (Update for Tiramisu)
(diff) ← Older revision | Latest revision (diff) | Newer revision → (diff)
Jump to navigation Jump to search
Setting up linux-wiiu
Last update 2022-08-22
DTB image dtbImage.wiiu
linux loader fw.img

This page walks you through setting up linux-wiiu for the first time.


You should have these before starting with this guide:

  • A Wii U
  • An SD card
  • A USB keyboard
  • A display for your Wii U
  • A PC or Android phone
  • A USB drive for linux, at least 1GB recommended (All files will be deleted from this drive during the process)
  • An internet connection for the items below:
  • A flashable image (Available on a distribution's page or self-made)
  • The files from the Downloads section of the table on the right

The process


You need to have homebrew on your Wii U, specifically Tiramisu. If you don't already have it, follow hacks.guide - make sure to select fw.img loader on the Tiramisu for your café step in addition to what the guide suggests.

If you already have Tiramisu, download fw.img loader.

SD card setup

  1. Connect your SD card to your computer or Android phone.
  2. If you downloaded fw.img loader separately in the last step, copy the wiiu folder from the zip to the root of your SD card.
  3. Copy fw.img to the root of your SD card.
  4. Create a folder called linux on the root of the SD card and then copy dtbImage.wiiu into this folder.
  5. You can now put the SD card back in your Wii U.

USB setup

Follow the Flashing guide and come back to this page when finished.

Running Linux

Start up your Wii U. If you have Autobooting Tiramisu set up, hold B on the GamePad while the Wii U logo is onscreen. The window is a bit tight, so it may take a few attempts. If you do not have autoboot, hold B on the GamePad while opening Health and Safety.

If successful, you will see a menu with white text on a black background, providing options like default, nanddumper, etc. Select fw_img_loader and press A.

You will now load into linux. It may take some time and show a pink screen - this is normal, just wait.

You should be able to log in with the username root and password wiiu.

You can change your password by running passwd and expand the partition on the USB drive so you can use the whole drive by running /usr/local/share/linux-wiiu/rootfs_enlarge.sh (Openlogo-debianV2.svg Debian only)