Installation guide

This guide will cover the steps to install linux-wiiu on a Nintendo Wii U. It is assumed that you already have Cafe OS homebrew set up and working.

If you don’t already have homebrew, please set up Aroma before continuing.

Choosing a storage device

You will need an SD card for Cafe OS homebrew and for the bootloader, but you have more options when it comes to the storage medium for the distro itself.

• A USB storage device (like a flash drive) is easy to set up with disk images, but since the Wii U only supports USB 2.0, the system might feel slow and unresponsive. There are also hardware compatibility concerns with USB hard drives (search for Y Cables). Recommended for new users.
• An SD card partition performs a lot better and has no compatibility issues, but can be more difficult to set up since you have to manually partition the card instead of using disk images. Make sure you have a good-quality card!
• A 2.5” SATA storage device like a hard drive or solid state drive provides the best performance the Wii U has to offer, but requires installation of a SATA adapter board and removal of the optical drive. This obviously affects Cafe OS’s function.

Linux distribution

The distro is the set of programs you’ll run on your Wii U, and defines how the system looks and what it can do. Some distros have graphical desktops, while others might have a lightweight shell.

Distributions repackaged by linux-wiiu provide Flashable disk images (recommended), Partition images and tarballs.

1. Choose a distro from the left sidebar and download the SD files and one of the images or tarball.
2. Insert the Wii U’s SD card into your computer or connect over FTP. If using the Aroma FTP plugin, the SD card can be found at /fs/vol/external01.
3. Copy the contents of the SD files zip to the root of the SD card. You should have a fw.img file and a linux folder.

This sets up the bootloader and homebrew files, but we still need to store the distro image itself.

Flashable disk images

Flashable disk images will overwrite everything on a storage device and replace it with the Linux distro. Their major benefit is that you don’t have to do any extra setup to preserve your data, since they delete all the data by nature. Recommended for USB storage. Do NOT use for SD cards - the Cafe OS homebrew will be deleted!

In case that wasn’t clear, flashable images will delete everything on your storage device!

1. Download and open software that can flash disk images for you. If you don’t have one, Etcher is a fine choice.
2. Insert the USB drive into your PC, and copy off any data you don’t want to lose.
3. In your flashing software, select the disk image and then select the USB drive to flash.
4. Start the flashing process.

Tarballs

Tarballs - usually .tar.xz files - contain all the files for the Linux distro, but need to be unpacked into an appropriate filesystem before they can be used. Best bet for SD card partitions.

(TODO) This part of the guide is not yet written. In short:

1. Partition
2. Format as ext4 with -O ^metadata_csum,^64bit (or you’ll get unsupported features when mounting)
3. Unpack tarball
4. Unmount, sync, eject.

Booting

At this point, you’re ready to go!

1. Reinsert your SD card to the Wii U and turn it on.
2. Hold B on the Gamepad during boot. You should see a white-on-black menu. If you see the Environment Loader menu or the Tiramisu/Aroma boot menus, reboot and try again. This can be tricky since the GamePad often boots too slowly and you miss the timing.
3. Navigate to fw_img_loader and press A.
4. Linux will load into “Petitboot”, the linux-wiiu bootloader. Give it a moment and your USB, SD card etc. should appear with the name of the distribution.
5. Use a USB keyboard to navigate up to your distribution and press Enter too boot it!

Have fun! Make sure to send us a picture of your working system on Matrix or Discord :)