Build your own image

You need Docker and about 30 GB of free disk space.

# On Windows, run this inside WSL (install it first with: wsl --install)
sudo apt update && sudo apt install docker.io -y
sudo service docker start
sudo usermod -aG docker $USER
newgrp docker

git clone https://github.com/ps5-linux/ps5-linux-image
cd ps5-linux-image
chmod +x ./build_image.sh

# Single distro: ubuntu2604, arch, cachyos or fedora
./build_image.sh --distro ubuntu2604
./build_image.sh --distro cachyos

# Multi-distro (Ubuntu + Arch + CachyOS, 32 GB image)
./build_image.sh --distro all

# Build only the kernel packages (.deb / .pkg.tar.zst), no image
./build_image.sh --kernel-only

# Build against a specific ps5-linux-patches branch, tag or commit
./build_image.sh --distro arch --patches-ref main

Images are written to output/; kernel-only builds go to linux-bin/. A second run reuses the kernel and root filesystem from the cache; --clean starts from scratch.

WSL running out of memory during the build?

Create or edit C:\Users\<you>\.wslconfig and raise the memory limit:

C:\Users<you>.wslconfig
[wsl2]
memory=8GB

Then restart WSL with wsl --shutdown.

Next steps

Flash the image to USB, then start Linux and work through the first boot.

Next steps​

Next steps