3. Linux Install/Update Guide
Installation guide/tutorial for Switchroot L4T Ubuntu on Nintendo Switch
If you need help you can ask in our Discord Server
You should also take a look at our FAQ and Common Issues which may already answer to some of your questions
The important parts of the guide are the Installation and Update sections.
You can skip the rest if you don't want extra information about the project.
If you come from a previous release and need to update.
- In L4T Ubuntu Linux, go to the
Software Updater
app and click "Install Now" Or open terminal and execute:sudo apt update && sudo apt-get dist-upgrade
. After update is finished, reboot and done.- If Nvidia BSP was forcefully changed, creating a
.reinit
file into bootfiles directory (sd:/switchroot/{distro}/
) will restore Kernel, Kernel Modules, Firmware and other important things on the next boot and make the installation working again. It can also be used if updater somehow failed to extract the modules and firmware.
- If you haven't already, go to
hekate
->Nyx Options
->Dump Joy-Con BT
and dump Joycon pairing data, with both Joycon connected to console, after first pairing them in hos.
- A 16GB SD Card MINIMUM (Recommended: 128GB and up U3 or U3/A2 class)
- A computer (for backing up and extracting the installation files)
- 1.
- 2.Backup your SD Card:
- Backup normal files from FAT32 (this also backs up emuMMC if file based)
- If emuMMC raw partition exists, go to
hekate
->Tools
->Backup eMMC
.Tap onSD emuMMC RAW Partition
button and back it up (emuMMC BOOT0/1
andemuMMC Raw GPP
) - If android exists, do a TWRP backup Suggestion: Use hekate UMS (
hekate
->Tools
->USB Tools
) with a USB-C cable connecting your switch and PC to mount your SD card and transfer files instead of swapping your card from Switch to PC.
- 3.WARNING: This following will wipe everything on your SD card. Partition your SD card in
hekate
->Tools
->Partition SD Card
leave at least 5GB for FAT32 for installation files downloaded in step 1 AND recreate any partition that may have backed up. - 4.From your PC, extract the 7z to your SD FAT32 partition. Suggestion: Use hekate UMS (
hekate
->Tools
->USB Tools
) with a USB-C cable connecting your switch and PC to mount your SD card instead of swapping your card from Switch to PC. - 5.In Hekate, go to
Tools
->Partition SD Card
->Flash Linux
. - 6.Go to
hekate
->Nyx Options
->Dump Joy-Con BT
to dump Joycon pairing data, with both Joycon connected to console, after they were paired in hos first. This must be run even if a Switch Lite is used, since it dumps the calibration data. - 7.Now you can boot L4T Ubuntu. Make sure any existing online updates are done via
Software Updater
orapt
command. - 8.After making sure everything is fine, you can now restore your backed up files
- Copy your normal files to FAT32
- For emuMMC use Hekate to restore your backup
hekate
->Tools
->Restore eMMC
Tap onSD emuMMC RAW Partition
button and restore it up (emuMMC BOOT0/1
andemuMMC Raw GPP
) - For Android, copy your TWRP backup to your FAT32 partition then follow the steps and 4 of our android BUT instead of installing "Lineage zip, followed by your GApps zip" at step 4.g restore your backup in TWRP
- Use the L4T-Megascript app, available in your apps list (installed by default in 3.4.0+) You can get or build various essential stuff, apps or emulators with a single click. All configured and optimized for Switch.
CTCaer (kernel/bootloader, distro maintainer, NVENC/NVDEC)
Gavin_Darkglider (distro maintainer)
Azkali (distro maintainer)
Ave (repo management and host)
DanielOgorchock (Switch controller drivers/joycond)
Bylaws
Langerhans
Natinusala
stary2001 (reboot2payload)
theofficialgman and cobalt2727 (L4T-Megascript)
NVIDIA (Tegra BSP)
Everyone else in switchroot
Last modified 1mo ago