Current version: 5.1.2 based on Ubuntu Jammy 22.04 LTS
Disclamer: This is BETA SOFTWARE. You may run into issues (that you can report in the Discord Server) and you might possibly need to install from a fresh image in the future.
Note: hekate 6.0.6 or newer should be used for this release.
If you need help you can ask in our Discord Server under #jammy-support
You should also take a look at our FAQ and Common Issues which may already answer to some of your questions
The important part of the guide is the Installation section.
You can skip the rest if you don't want extra information about the project.
hekate
-> Tools
-> Backup eMMC
.SD emuMMC RAW Partition
button and back it up (emuMMC BOOT0/1 and emuMMC Raw GPP)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.hekate
-> Tools
-> Partition SD Card
leave at least 6GB 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.
Now you can boot L4T Ubuntu Jammy.
Make sure any existing online updates are done via Software Updater
, Software
(formerly known as Gnome Software Center), or apt
command.
After making sure everything is fine, you can now restore your backed up files
hekate
-> Tools
-> Restore eMMC
These features are currently missing in comparison to L4T Ubuntu 18.04 and may be available in future releases.
theofficialgman (ubuntu jammy distro maintainer, L4T-Megascript)
CTCaer (kernel/bootloader, ubuntu bionic distro maintainer, NVENC/NVDEC),
Gavin_Darkglider (lakka distro maintainer),
Azkali (fedora distro maintainer),
Ave (repo management and host),
DanielOgorchock(Switch controller drivers/joycond),
Bylaws,
Langerhans,
Natinusala,
stary2001 (reboot2payload),
NVIDIA (Tegra BSP),
cobalt2727 (L4T-Megascript),
Everyone else in switchroot