• We had to restore from a backup today after a failed software update. Backup was from 0000 EDT and restored it at 0800 EDT so we lost about 8hrs. Today is 07/20/2024. More info here.

Linux on the Wii


Jarret W. Buse

Linux on the Wii

The title is not a typo. Yes, you can run Linux on the Nintendo Wii system. There are a few things to note.

The Linux version is Debian version 5 called 'Lenny'. To run Linux on the Wii, you need to install 'The Homebrew Channel' (HBC).

NOTE: Keep in mind, that installing HBC can invalidate the warranty and make you wish for the way it was yesterday.

First, let's look over the Wii itself. The Wii system is an Arm 9 Core running at 243 MHz with a Starlet coprocessor. Nintendo's Operating System (OS) is called either 'Input Output Systems' or 'Internal Operating Systems' (IOS).

The Linux kernel used can support the following:

  • Wii Remotes
  • Wi-fi
  • USB
  • Bluetooth (for remotes)
  • Gamecube Controllers (not Gamecube memory)
  • USB Geckos
  • DVD drive

NOTE: Be aware that the Wii remotes are based on Bluetooth for communication. The Wii sensor bar is not supported initially, but there are ways to enable it.

There are three hardware devices that are required to get Linux enabled on the Wii:

  • SD Card (2 GB or less and not an SDHC)
  • USB keyboard
  • Wii with Homebrew

Let's look at getting The Homebrew Channel on your Wii.

NOTE: Again, be aware that this can invalidate your warranty. Also, once The Homebrew Channel is installed, you will not want to allow system updates. By updating the firmware through WiiConnect24, the changes you make can be removed and you will have to perform the steps again. If your Wii system asks if it can download updates, let it be and answer 'No'.

Before starting the Homebrew installation, you need to check three things:

  1. System Menu Version
  2. MAC Address
  3. Test Internet Connection

Start your Wii and select 'Wii Options' from the Main Menu. At the Options Menu in the top right is the System Menu Version. At the time of this writing, the current version is 4.3. A letter follows it to designate your region, mine is 'U'. So, my full version number is 4.3U.

Select Internet Settings so you can verify your Internet connection is working. Select the option to perform a Connection Test. If prompted to perform an update, answer 'No'.

Go back to select the option for the Console Information. Listed here is the MAC Address of the WII Wi-Fi device. Make note of the address for later.

Go to another system with Internet access and go to the website 'please.hackmii.com'. Here you will be shown a screen as in Figure 1. Select your System Menu Version, enter in your MAC Address being very careful to get it correct and then type in the Captcha. Make sure the checkbox is checked for 'Bundle the HackMii Installer for Me'. Once done, select either button 'Cut Red Wire' or 'Cut Blue Wire'. You should be prompted to download the file. Save the file somewhere accessible.

Figure 1.jpg


Once downloaded, open the compressed file and extract it to your newly formatted SD card.

NOTE: Make sure the SD card is formatted as FAT32.

Turn off the Wii, place the SD card in the front slot of the Wii, then turn the system back on.

Once on, at the Main Menu, select Messages. In the Messages for the previous day, current day or next day should be a red letter labeled 'LetterBomb'. Open the LetterBomb, and when prompted, press '1' to continue. In the HackMii installer, select 'A'. Next, move up the menu to highlight the option 'Install the Homebrew Channel' then select the option. When prompted to install the Homebrew Channel, select 'Yes'. When the installation is completed, select to continue and at the menu select the option to 'Exit'.

You should now be in the Homebrew Channel and can select the Home button to get a menu where you have the option to 'Exit' the Homebrew Channel.

Back at the Wii Main Menu, you should now see the Homebrew Channel listed with the other channels.

Now, you need to get the Whiite software as well as prepare the SD card for its use. The links are as follows:

Once downloaded, you need to prepare your SD card for booting. Attach your SD card to your Linux system and unmount it, then partition it by doing the following command from a shell:

sudo /sbin/fdisk /dev/sdx

NOTE: The SD card can be sdb or the like. I will refer to the SD card as drive sdx.

Once the fdisk program starts, press 'o' to remove all partitions and create a bootloader partition. At the next 'command:' prompt within fdisk, type 'n' for a new partition. Enter 'p' for a primary partition. Specify '1' for the first partition. When prompted for the first cylinder, press enter for the default. For the 'Last cylinder or size' prompt, enter '+256M' for 256 MB. You can specify more space, but you need the second partition to have more room to grow.

After the first partition is created, the partition format must be set. At the 'command:' prompt, type 't'. Specify the selected partition as '1'. The Hexcode for the format type is '6' to specify FAT16.

To create the second partition, type 'n' at the 'command:' prompt. Type 'p' for primary partition. When prompted for the partition number, enter '2'. For the 'First cylinder' and 'last Cylinder' press enter to accept the defaults.

When at the 'command' prompt, type 'p' to see a list of the partition table. You should see two partitions, one being FAT16 and the other a Linux format. At the 'command:' prompt, type 'w' to write the partition information to the SD card.

Now, we need to perform the next two commands in the shell to format the partitions:

  • sudo /sbin/mkfs.vfat -n boot /dev/sdx1
  • sudo /sbin/mkfs.ext3 -L whiite /dev/sdx2
The first partition is FAT16 and called boot, while the second partition is EXT3 and named whiite.

Now, we need to place the kernel into the boot partition with all necessary permissions which are stored in the compressed file. To do this, mount the boot partition and perform the following command:

  • sudo tar -C /media/boot -xjvf /folder/gc-linux-mikep5-v2.6.32+whiite-1.10.tar.bz2 -o --strip-components 1

The file location is noted as /folder/. Replace the proper location as needed.

Unmount the boot partition and mount the whiite partition to place the filesystem image on it. To place the filesystem image on the partition do the following command:

  • sudo tar -C /media/whiite -xjvf /folder/gc-linux-mikep5-v2.6.32+whiite-1.10.tar.bz2.tar.bz2

Unmount the drive and place the SD card in the front slot of the Wii. Start the Wii and at the system menu select Homebrew and then press 'Start'. Within Homebrew, a tab should appear named Whiite-Linux. Select it and wait.

NOTE: If the screen remains black, power off the Wii and try again.

When asked for a login username, type 'root'. For the password type 'whiite'.

NOTE: For some special keys like '/,*,-,etc', use the numeric keypad for these keys.

You are now running Linux on your Wii. Obladi Oblada, or as my kids may say, 'Happiness is a warm Wii'.


  • slide.jpg
    5 KB · Views: 45,017

Has anyone successfully tried this? Are there any updates to this post?
I ask because my son's old Wii U is just gathering dust... so I might as well put it to good use.
Do we know if this works with the Wii U as well?
I'm not concerned with the warranty at this point :)
This was imported from backups when we relaunched the site a few years ago, so @Jarret B is showing up as a guest in this one - but now that I tagged him, he'll prob stop in and let us know if he's still aware of this or not..
Cool. Thanks. Looking forward. I'll probably take a shot nonetheless. Best case scenario I'm successful, worst case scenario I brick the machine and it goes back on the shelf where it has been for two years anyway.
The tutorial works for me.
I've noticed a mistake:
it's not gc-linux-mikep5-v2.6.32+whiite-1.10.tar.bz2.(tar.bz2) which need to be used for the whiite partition but the debian-lenny-5.0+whiite-1.10.tar.bz2 file.
And last thing, how to easily identify the name of our SDcard? Because I had a lot of trouble finding it was recognized as "sde" by my PC.

PS: any ideas of what I could do on my Wii now ?
AYUDA ME PERDI AL FINAL,alguien me puede explicar con manzanitas y otra cosa,tambien se puede instalar desde windows???? please
AYUDA ME PERDI AL FINAL,alguien me puede explicar con manzanitas y otra cosa,tambien se puede instalar desde windows???? please
Este es un foro de habla inglesa, publique su pregunta o problema en inglés. Además, tendrá más posibilidades de que se responda a su tema si crea un tema nuevo por su cuenta. Gracias!
Hey folks, I just stumbled upon this forum and was wondering if this Debian Distro is the only version of Linux that works on a Wii. I was recently pondering if installing a different distro on the Wii would be possible. I was thinking Pop OS (I understand this isn't a System76 forum). I already have BootMii, Priiloader, & HBC installed. I suppose I'm just asking if it's possible to boot the ISO from the SD card from the BootMii menu to get to the "try it out" desktop of the said distro in order to test installing/overwriting the entire default Wii system for Pop OS. I couldn't find any recent info online for such a newer Linux distro and I'm trying to repurpose old tech, like this Wii, in order to get better use out of it. I already have a 2nd Wii fully Homebrewed as a retro console with all the games I can handle. lol.
I was thinking Pop OS (
Keep thinking, as your kit is not system 76 you could run into loads of compatibility problems
Wii have ARM CPU's so you will have to pick a distribution which supports ARM
This is not something I would consider doing, although from my understanding, it has been possible for about the last 10 years
I wonder what happened to the OP...given it's been 9 years.
Here are dumb questions:

When you're done, you've turned a Wii into an ordinary Linux computer with an unusual pointing device and other peripherals. Is that right?

Can you play Wii games under this arrangement?
When you're done, you've turned a Wii into an ordinary Linux computer with an unusual pointing device and other peripherals.

I can kinda address this one. You can use a keyboard and mouse with a Wii.

Alas, I'm not a gamer. Beyond that, I have no idea.
I can kinda address this one. You can use a keyboard and mouse with a Wii.

Alas, I'm not a gamer. Beyond that, I have no idea.
That much I figured out on my own. I am not a gamer, either.

I was curious to know whether you can run Nintendo games on it somehow. My gut says no.
I wonder what happened to the OP...given it's been 9 years.

Have a look at the front page articles, he is very active.

We had a major software upgrade of the site in late April 2017. Any members from prior to that time who wanted to continue had to rejoin.

Members who posted prior to that time are listed as Guest.


BTW @h.becerra.81 - if you Google

linux nintendo wii

you will find a number of references.

Welcome to linux.org

Chris Turner
Thats incredibly interesting, anyone know what you can use this for?

Nintendo wii was a good system, i had one recently but it freakin broke.
Love all the Beatles song references. Good article. Love your work

Members online