Installation Guide - Revision history

Techflash: those options are no longer necessary to disable in 4.19

2025-05-12T16:04:20Z

those options are no longer necessary to disable in 4.19

← Older revision		Revision as of 16:04, 12 May 2025
Line 48:		Line 48:
	#* If you are using USB storage for the root, you don't need to partition the SD card.		#* If you are using USB storage for the root, you don't need to partition the SD card.
	# Format the root partition as ext4.		# Format the root partition as ext4.
	~~#* You will need to ensure that the <code>verity</code> and <code>metadata_csum_seed</code> ext4 features are disabled, because the Wii Linux kernel is too old to support them.~~		#* <code>sudo mkfs.ext4 -L 'arch' /dev/[root block device here]</code>
	#* <code>sudo mkfs.ext4 ~~-O '^verity' -O '^metadata_csum_seed'~~ -L 'arch' /dev/[root block device here]</code>
	# Extract the SD card files to the SD card's FAT32 partition.		# Extract the SD card files to the SD card's FAT32 partition.
	## <code>sudo mount /dev/[SD card block device here] /mnt</code>		## <code>sudo mount /dev/[SD card block device here] /mnt</code>

Techflash: actually fix the typo

2024-12-11T23:24:23Z

*actually* fix the typo

← Older revision		Revision as of 23:24, 11 December 2024
Line 23:		Line 23:
	== PC Installer ==		== PC Installer ==

	'''If you get any errors during this process, please ask for help via #support in (https://discord.gg/K6ea48VUXU the Wii-Linux Discord Server)'''		'''If you get any errors during this process, please ask for help via #support in [https://discord.gg/K6ea48VUXU the Wii-Linux Discord Server]'''

	# Download the installer		# Download the installer

Selimgozel1: Typo

2024-12-11T19:34:07Z

Typo

← Older revision		Revision as of 19:34, 11 December 2024
Line 23:		Line 23:
	== PC Installer ==		== PC Installer ==

	'''If you get any errors during this process, please ask for help via #support in [https://discord.gg/K6ea48VUXU the Wii-Linux Discord Server)'''		'''If you get any errors during this process, please ask for help via #support in (https://discord.gg/K6ea48VUXU the Wii-Linux Discord Server)'''

	# Download the installer		# Download the installer

Techflash: Complete the installation guide

2024-12-11T19:04:58Z

Complete the installation guide

← Older revision		Revision as of 19:04, 11 December 2024
Line 1:		Line 1:
	This guide will walk you through the process of setting up a Wii-Linux system using the official [[ArchPOWER]] images.		This guide will walk you through the process of setting up a [[Wii-Linux]] system using the official [[ArchPOWER]] images.

	== Requirements ==		== Requirements ==

	* A Wii modified to run homebrew apps via BootMii ([https://wii.hacks.guide/ Wii Hacks Guide] will walk you through this process)		* A Wii modified to run homebrew apps via BootMii ([https://wii.hacks.guide/ Wii Hacks Guide] will walk you through this process)
	* An SD ~~or SDHC~~ card (~~no larger than 32 GB~~, ~~can also be used for other homebrew as space allows~~)		* An SD card of at least 2GB (unlike official Wii Software, Wii-Linux doesn't require an SDHC or smaller SD Card)
	* USB storage device for the root partition (optional)		* USB storage device for the root partition ('''''optional''''')
	* Access to a Linux system		* Access to a Linux system that can hold your root partition
	** GNU tar is '''required''' to properly extract the rootfs.		** GNU tar is '''required''' to properly extract the rootfs.
	** We assume this is a physical machine. Virtual machines will require special configuration to pass through the root device, which is beyond the scope of this guide		** We assume this is a physical machine. Virtual machines will require special configuration to pass through the root device, which is beyond the scope of this guide
Line 13:		Line 13:
	We also assume you are comfortable with technical tasks like partitioning media and installing packages.		We also assume you are comfortable with technical tasks like partitioning media and installing packages.

	== ~~Preparing Media~~ ==		== Installation process ==

			# Ensure that you meet the [[#Requirements\|requirements]].
			# Identify which install process you would like to use, [[#PC Installer\|the script-based PC Installer]], or [[#Manual Installation\|Manual Installation]]
			# Follow the steps shown for that process.
			# Continue to [[#Booting\|boot the system]] and [[#After boot\|after-boot setup]] to set up anything you'd like (such as networking)
			# Success!

			== PC Installer ==

			'''If you get any errors during this process, please ask for help via #support in [https://discord.gg/K6ea48VUXU the Wii-Linux Discord Server)'''

			# Download the installer
			#* <code>git clone https://github.com/Wii-Linux/pc-installer</code>
			# Run the installer
			#* <code>cd pc-installer; sudo ./installer.sh</code>
			# Select what disk you would like to use by it's number listed in the brackets
			# Pick whether or not you would like to store the root filesystem on a different device (for example, USB storage).
			#* If yes, you must have followed the partitioning steps from [[#Manual Installation\|the manual installation section]].
			#* If yes, you will be prompted to select your root device shortly.
			# If you didn't chose yes above, you'll be asked if you want to do an Automatic or Manual install.
			#* Automatic will partition and format your SD Card for you
			#* Manual will assume that you've partitioned your SD Card already, and will format the partitions you specify if you haven't already.
			# After the card has been partitioned, the necessary files will be downloaded and installed for you.
			# You will need to answer a few configuration questions.
			# Success! Continue to boot your freshly prepared install!

			== Manual Installation ==

	# From the [https://wii-linux.org/downloads Wii Linux downloads page], download "Latest build's ArchPOWER rootfs (.tar.gz)" and "Latest build's ArchPOWER SD Card files".		# From the [https://wii-linux.org/downloads Wii Linux downloads page], download "Latest build's ArchPOWER rootfs (.tar.gz)" and "Latest build's ArchPOWER SD Card files".
	# Partition the media. You will need a FAT32 partition on your SD card, and will need an ext4 partition on either the SD card or USB storage.		# Partition the media. You will need a FAT32 partition on your SD card, and will need an ext4 partition on either the SD card or USB storage.
	#* The SD card files take up around 34 megabytes of space. To ensure plenty of space for updating, we recommend at least ~~512 MB~~ for the FAT partition.		#* The SD card files take up around 34 megabytes of space. To ensure plenty of space for updating, we recommend at least 256MB for the FAT partition.
			#** If you plan to use other Wii homebrew from your SD Card, you probably want to have more space, likely at least 1GB
	#* If you are using USB storage for the root, you don't need to partition the SD card.		#* If you are using USB storage for the root, you don't need to partition the SD card.
	# Format the root partition as ext4.		# Format the root partition as ext4.
Line 31:		Line 59:
	## <code>cd /mnt</code>		## <code>cd /mnt</code>
	## <code>tar -xvP --acls --xattrs --same-owner --same-permissions --numeric-owner --sparse -f [/path/to/rootfs.tar.gz]</code>		## <code>tar -xvP --acls --xattrs --same-owner --same-permissions --numeric-owner --sparse -f [/path/to/rootfs.tar.gz]</code>
	##* You ''must'' use these flags to extract the rootfs properly		##* You '''must''' use these flags to extract the rootfs properly
	## <code>sync; cd; sudo umount /mnt</code>		## <code>sync; cd; sudo umount /mnt</code>
	# Remove the SD card and root device from the Linux machine.		# Remove the SD card (and root device if you have a dedicated one) from the Linux machine.

	== Booting ==		== Booting ==
Line 41:		Line 69:
	#* If you were able to install BootMii as boot2, your Wii will automatically enter BootMii.		#* If you were able to install BootMii as boot2, your Wii will automatically enter BootMii.
	#* If you followed the Wii Hacks Guide and installed Priiloader, hold Reset as you power the Wii on, then select the "BootMii IOS" option.		#* If you followed the Wii Hacks Guide and installed Priiloader, hold Reset as you power the Wii on, then select the "BootMii IOS" option.
			#* You can also open the menu from the Homebrew Channel (HOME button on a Wii Remote, START button on a GameCube controller)
	# Wait for gumboot to load the kernel.		# Wait for gumboot to load the kernel.
	#* You can navigate the gumboot menu using the power and reset buttons on the Wii, or the D-pad on a ~~Gamecube~~ controller, but that isn't needed for the first boot.		#* You can navigate the gumboot menu using the power and reset buttons on the Wii, or the D-pad on a GameCube controller, but that isn't needed for the first boot.
	# At the Wii Linux boot menu, select ArchPOWER (or wait).		# At the Wii Linux boot menu, select ArchPOWER (or wait a few seconds).
	# Watch the systemd boot messages and wait for the login prompt.		# Watch the systemd boot messages and wait for the login prompt.

Waterpear: write install guide, based on the install guide on the Discord

2024-11-14T19:41:09Z

write install guide, based on the install guide on the Discord

New page

This guide will walk you through the process of setting up a Wii-Linux system using the official [[ArchPOWER]] images.

== Requirements ==

* A Wii modified to run homebrew apps via BootMii ([https://wii.hacks.guide/ Wii Hacks Guide] will walk you through this process)
* An SD or SDHC card (no larger than 32 GB, can also be used for other homebrew as space allows)
* USB storage device for the root partition (optional)
* Access to a Linux system
** GNU tar is '''required''' to properly extract the rootfs.
** We assume this is a physical machine. Virtual machines will require special configuration to pass through the root device, which is beyond the scope of this guide
** Use of Windows Subsystem for Linux or the ChromeOS "Linux development environment" (aka Crostini) is also beyond the scope of this guide.

We also assume you are comfortable with technical tasks like partitioning media and installing packages.

== Preparing Media ==

# From the [https://wii-linux.org/downloads Wii Linux downloads page], download "Latest build's ArchPOWER rootfs (.tar.gz)" and "Latest build's ArchPOWER SD Card files".
# Partition the media. You will need a FAT32 partition on your SD card, and will need an ext4 partition on either the SD card or USB storage.
#* The SD card files take up around 34 megabytes of space. To ensure plenty of space for updating, we recommend at least 512 MB for the FAT partition.
#* If you are using USB storage for the root, you don't need to partition the SD card.
# Format the root partition as ext4.
#* You will need to ensure that the <code>verity</code> and <code>metadata_csum_seed</code> ext4 features are disabled, because the Wii Linux kernel is too old to support them.
#* <code>sudo mkfs.ext4 -O '^verity' -O '^metadata_csum_seed' -L 'arch' /dev/[root block device here]</code>
# Extract the SD card files to the SD card's FAT32 partition.
## <code>sudo mount /dev/[SD card block device here] /mnt</code>
## <code>cd /mnt</code>
## <code>tar -xzvf [/path/to/boot_files.tgz]</code>
## <code>cd; sudo umount /mnt</code>
# Extract the rootfs.
## <code>sudo mount /dev/[root block device here] /mnt</code>
## <code>cd /mnt</code>
## <code>tar -xvP --acls --xattrs --same-owner --same-permissions --numeric-owner --sparse -f [/path/to/rootfs.tar.gz]</code>
##* You ''must'' use these flags to extract the rootfs properly
## <code>sync; cd; sudo umount /mnt</code>
# Remove the SD card and root device from the Linux machine.

== Booting ==

# Insert the SD card and USB device into the Wii.
# Enter BootMii.
#* If you were able to install BootMii as boot2, your Wii will automatically enter BootMii.
#* If you followed the Wii Hacks Guide and installed Priiloader, hold Reset as you power the Wii on, then select the "BootMii IOS" option.
# Wait for gumboot to load the kernel.
#* You can navigate the gumboot menu using the power and reset buttons on the Wii, or the D-pad on a Gamecube controller, but that isn't needed for the first boot.
# At the Wii Linux boot menu, select ArchPOWER (or wait).
# Watch the systemd boot messages and wait for the login prompt.

== After boot ==

The login prompt will have the default root password, and will instruct you to run <code>helpmii</code> and <code>configmii</code> to help set up your system. Helpmii will let you read the [https://github.com/Wii-Linux/helpmii/blob/main/getstarted.txt Getting Started Guide] on your Wii, which will show you how to do important tasks like using <code>nmtui</code> to set up your Wi-Fi or Ethernet connection and how to add swap space.

You may want to check the [[Recommended Apps]] list to get started.

Installation Guide - Revision history

Techflash: those options are no longer necessary to disable in 4.19

Techflash: *actually* fix the typo

Selimgozel1: Typo

Techflash: Complete the installation guide

Waterpear: write install guide, based on the install guide on the Discord

Techflash: actually fix the typo