[{"data":1,"prerenderedAt":-1},["ShallowReactive",2],{"project-729":3},{"id":4,"name":5,"fullName":6,"owner":7,"repo":5,"description":8,"homepage":9,"htmlUrl":10,"language":11,"languages":10,"totalLinesOfCode":10,"stars":12,"forks":13,"watchers":14,"openIssues":15,"contributorsCount":16,"subscribersCount":16,"size":16,"stars1d":17,"stars7d":18,"stars30d":19,"stars90d":16,"forks30d":16,"starsTrendScore":20,"compositeScore":21,"rankGlobal":10,"rankLanguage":10,"license":22,"archived":23,"fork":23,"defaultBranch":24,"hasWiki":23,"hasPages":23,"topics":25,"createdAt":10,"pushedAt":10,"updatedAt":26,"readmeContent":27,"aiSummary":28,"trendingCount":16,"starSnapshotCount":16,"syncStatus":29,"lastSyncTime":30,"discoverSource":31},729,"ps5-linux-loader","ps5-linux\u002Fps5-linux-loader","ps5-linux","Linux payload implementing HV exploits to run a custom bootloader","",null,"C",1753,127,36,1,0,69,169,412,207,19.32,"GNU General Public License v3.0",false,"main",[],"2026-06-12 02:00:17","# ps5-linux\n\n**ps5-linux** leverages a patched HV vulnerability to transform your PS5 Phat console running **3.xx or 4.xx firmwares** into a highly capable Linux PC, unlocking its full hardware potential for desktop use. Powered by 8 CPU cores (16 threads) at **3.5 GHz** and a GPU at **2.23 GHz**, it provides enough performance to run Steam games and various emulators with impressive fluidity. It supports HDMI 4K60 video and audio output. Furthermore, it allows you to utilize an **M.2 SSD** as a dedicated Linux partition, as well as all USB ports on the console.\n\n![Alt Text](logo.webp)\n\n## PS5 firmware\n\n*ps5-linux* is currently only supported on PS5 Phat on 3.xx and 4.xx firmwares.\n\n- **3.00**, **3.10**, **3.20**, **3.21**, without M.2 support\n- **4.00**, **4.02**, **4.03**, **4.50**, **4.51** with M.2 support\n\nSupport for 1.xx and 2.xx firmwares may be added in the future, but we will not prioritize this effort.\n\nSupport for 5.xx firmwares may be added in the future, but for those firmwares, Linux will run within the GameOS VM, thus it will have less features (still unknown what limitations there will be) and it may not perform as good.\n\nIf you want to update to a specific firmware, [download the correct PUP](https:\u002F\u002Fdarthsternie.net\u002Fps5-firmwares\u002F) and follow the [official guide](https:\u002F\u002Fwww.playstation.com\u002Fen-us\u002Fsupport\u002Fhardware\u002Freinstall-playstation-system-software-safe-mode) to upgrade your PS5.\n\n## Hardwares\n\nTo run *ps5-linux*, you need some required and optional hardwares:\n\n- **Required**: USB drive with minimum 64GB (ideally external SSD) to install and run Linux.\n- **Required**: USB Ethernet\u002FWLAN adapter for internet access.\n- **Required**: USB keyboard\u002Fmouse (dongles supported too).\n- *Optional*: M.2 SSD compatible on PS5 (see [official guide](https:\u002F\u002Fwww.playstation.com\u002Fen-us\u002Fsupport\u002Fhardware\u002Fps5-install-m2-ssd)) to run Linux from SSD.\n- *Optional*: Bluetooth dongle to connect with PS5 DualSense controller.\n\n\n## Configure PS5 settings\n\n- **Required**: Enable Rest Mode features:\n  - Go to `Settings` → `System` → `Power Saving` → `Features Available in Rest Mode` and set `Supply Power to USB Ports` to `Always`.\n- **Required**: Disable HDMI Device Link:\n  - Go to `Settings` → `HDMI` → `Enable HDMI Device Link`\n- *Recommended*: Disable automatic updates:\n  - Go to `Settings` → `System Software` → `System Software Update and Settings`\n- *Recommended*: Disable automatic error reporting:\n  - Go to `Settings` → `System Software` → `Report System Software Errors Automatically`\n\n## Installation\n\n### 1. Get a Linux image\n\n#### Linux\u002FmacOS:\n\nInstall docker:\n\n```bash\nsudo apt update\nsudo apt install docker.io -y\nsudo service docker start\nsudo usermod -aG docker $USER\n```\n\nRestart the terminal.\n\n```bash\ngit clone https:\u002F\u002Fgithub.com\u002Fps5-linux\u002Fps5-linux-image\ncd ps5-linux-image\nchmod +x .\u002Fbuild_image.sh\n.\u002Fbuild_image.sh --distro ubuntu2604\n```\n\n#### Windows (WSL2):\n\nIf WSL2 is not installed yet, run this in PowerShell or CMD as administrator, then restart:\n\n```bash\nwsl --install\n```\n\nThen open WSL and set up Docker:\n\n```bash\nsudo apt update\nsudo apt install docker.io -y\nsudo service docker start\nsudo usermod -aG docker $USER\n```\n\nRestart WSL from PowerShell\u002FCMD:\n\n```bash\nwsl --shutdown\n```\n\nThen clone and build:\n\n```bash\ncd ~\u002F\ngit clone https:\u002F\u002Fgithub.com\u002Fps5-linux\u002Fps5-linux-image\ncd ps5-linux-image\nchmod +x .\u002Fbuild_image.sh\n.\u002Fbuild_image.sh --distro ubuntu2604\n```\n\nThe finished image is written to `output\u002Fps5-ubuntu2604.img`.\n\n### 2. Flash the image to USB\nMinimum drive size: 64 GB. An external SSD is strongly recommended.\n\n#### Linux\u002FmacOS:\n\n```bash\n# check drive name with lsblk \u002F diskutil list\nsudo dd if=output\u002Fps5-ubuntu2604.img of=\u002Fdev\u002FsdX bs=4M status=progress conv=fsync\n```\n\n#### Windows (Balena Etcher):\n\nDownload [Balena Etcher](https:\u002F\u002Fetcher.balena.io\u002F), select the .img file, select your USB drive, click Flash.\n\n### 3. Plug the USB drive into your PS5\n\nThe following USB ports are supported for booting:\n\n- Front bottom Type-C port\n- Rear Type-A ports\n\nThe front top Type-A port is USB 2.0 which is slower and thus not recommended.\n\n### 4. Run the jailbreak exploit\n\n1. Clone https:\u002F\u002Fgithub.com\u002Fidlesauce\u002Fumtx2\n2. Configure fakedns via `dns.conf` to point `manuals.playstation.net` to your PCs IP address\n3. Run fake dns: `python fakedns.py -c dns.conf`\n4. Run HTTPS server: `python host.py`\n5. Go into PS5 advanced network settings and set primary DNS to your PCs IP address and leave secondary at `0.0.0.0`\n6. Go to user manual in settings and accept untrusted certificate prompt, run.\n\n#### 5. Send the payload\nEither download [ps5-linux-loader.elf](https:\u002F\u002Fgithub.com\u002Fps5-linux\u002Fps5-linux-loader\u002Freleases\u002F), or install [ps5-payload-sdk](https:\u002F\u002Fgithub.com\u002Fps5-payload-dev\u002Fsdk) and compile it yourself:\n\n```bash\ngit clone https:\u002F\u002Fgithub.com\u002Fps5-linux\u002Fps5-linux-loader\ncd ps5-linux-loader\nmake\n```\n## Compiling on ARM64 Linux\n\nInstall the x86-64 cross-compilation tools before:\n\n```bash\nsudo apt install gcc-x86-64-linux-gnu binutils-x86-64-linux-gnu\n```\n\nFind your PS5 IP at `Settings → Network → View Connection Status`.\n\n```bash\nsocat -t 99999999 - TCP:192.168.178.127:9021 \u003C ps5-linux-loader.elf\n```\n\nIf all is successful, the payload will automatically go into rest mode. Wait until the orange LED stops blinking and becomes static. Only then, press the power button again to boot your PS5 into Linux. If the boot is successful, **the LED should turn white**. If it boots back into PS5 OS, then it's because you pressed the power button too early. Or, you did not enable rest mode features as described above.\n\nIf the LED is white, but you still have a blackscreen then:\n\n- Try removing `video=DP-1:1920x1080@60` line in cmdline.txt.\n- Try different monitors or capture cards, ideally with different resolutions. Currently, some monitors have issues.\n- Try setting `amdgpu.force_1080p=1` in `cmdline.txt` in the FAT32 partition of the USB drive.\n\nIf none of this helps, please report the issue in our [Discord server](https:\u002F\u002Fdiscord.gg\u002FPeMGVB7BAm) and provide your EDID information.\n\n\n## First Boot\n\nConfigure your system and memorize your login password.\n\nThen, there are certain settings and commands we recommend doing:\n\n1. Disable screen saver, as it is currently buggy.\n\n2. Possibly, you have to disable and reenable your Wired\u002FWLAN connection to get internet connection.\n\n3. Hold packages to prevent updating the kernel when doing `apt upgrade`:\n   ```bash\n   sudo apt-mark hold linux-generic linux-generic-hwe-24.04 linux-generic-hwe-26.04 linux-image-generic linux-image-generic-hwe-24.04 linux-image-generic-hwe-26.04 linux-headers-generic linux-headers-generic-hwe-24.04 linux-headers-generic-hwe-26.04\n   ```\n\n4. Install Firefox:\n\n   ```bash\n   sudo snap install firefox\n   ```\n\n5. Update mesa:\n\n   ```bash\n   sudo snap refresh mesa-2404 --channel=latest\u002Fedge\n   ```\n\n6. Clone our [ps5-linux-tools](https:\u002F\u002Fgithub.com\u002Fps5-linux\u002Fps5-linux-tools):\n\n   ```bash\n   sudo apt install zlib1g-dev\n   git clone https:\u002F\u002Fgithub.com\u002Fps5-linux\u002Fps5-linux-tools\n   cd ps5-linux-tools\n   make\n   ```\n\n## M.2 installation\n\nYou can use a M.2 SSD exclusively for Linux (which means you cannot use it for PS5 game storage).\n\n1. Attach the M.2 SSD by following the [official guide](https:\u002F\u002Fwww.playstation.com\u002Fen-us\u002Fsupport\u002Fhardware\u002Fps5-install-m2-ssd).\n2. **VERY IMPORTANT**: If you used the M2. SSD for games before, reformat it on the PS5 under `Settings` → `Storage` → `M.2 SSD Storage`.\n3. Boot Linux on your PS5 and run these commands to initialize your M.2:\n\n```bash\ncd ps5-linux-tools\nsudo .\u002Fm2_init\n```\n\n4. Reboot via `sudo reboot`. If your PS5 asks you to format your M.2 again, please report this issue to us in our [Discord server](https:\u002F\u002Fdiscord.gg\u002FPeMGVB7BAm) and provide your M.2 model and storage size.\n5. Relaunch Linux on your PS5.\n6. Copy the `ps5-ubuntu2604.img` image that you built during installation or rebuild it on your PS5. Then, install it onto your M.2:\n\n```bash\ncd ps5-linux-tools\nchmod +x .\u002Fm2_install.sh\nsudo .\u002Fm2_install.sh --install $PATH_TO_YOUR_IMG\n```\n\nNow, you can boot into Linux on your M.2 via:\n\n```bash\ncd ps5-linux-tools\nchmod +x .\u002Fm2_exec.sh\nsudo .\u002Fm2_exec.sh\n```\n\nThen follow the same instructions again as the previous section.\n\nIn order to always boot Linux from your M.2, you can edit the label at `\u002Fboot\u002Fefi\u002Fcmdline.txt` from `root=LABEL=ubuntu2604` to `root=LABEL=ubuntu2604-m2`.\n\n## Fan & boost control\n\nWe provide a simple tool that allows you to boost your CPU to 3500Mhz and GPU to 2230MHz as well as changing the fan curve:\n\n```bash\ncd ps5-linux-tools\nsudo .\u002Fps5_control --fan on\nsudo .\u002Fps5_control --boost on\n```\n\nAlways turn on fan when your turn on boost, as this is what the official PS5 OS does.\n\n## FAQ\n\n- Q: Can I dual-boot Linux and PS5 OS?\n  - A: No, this is a soft-mod. You need to re-run the exploit in order to boot into Linux.\n- Q: Can I put Linux into standby and resume?\n  - A: No, this is not supported. We may however add a shutdown feature that puts your PS5 into rest-mode allowing you to relaunch Linux when powering up again.\n- Q: Can I continue using my PS5 if I install Linux?\n  - A: Yes, the internal SSD is not modified\n- Q: Can I use the PS5's NIC\u002FWLAN module in Linux?\n  - A: In theory yes, but someone needs to write or adapt drivers to use them.\n- Q: Will higher >=6.xx firmwares be supported?\n  - A: No.\n- Q: Does the DualSense controller work?\n  - A: Via a Bluetooth dongle. Built-in Bluetooth is not yet supported.\n- Q: What resolutions and refresh rates are supported?\n  - A: 1080p, 1440p and 2160p at 60Hz are broadly supported. 1440p@120Hz has been the only confirmed working on the DELL S3225QC yet. 120Hz or 30Hz may be added in the future.\n\n\n## Tips and tricks\n\n- If you see graphical issues in your games, add the environment variable `RADV_DEBUG=nohiz` as [recommended for BC250](https:\u002F\u002Felektricm.github.io\u002Famd-bc250-docs\u002Fdrivers\u002Fenvironment\u002F#critical-environment-variables) as well.\n- You can adjust the kernel cmdline in `cmdline.txt` in the FAT32 partition.\n- You can adjust the VRAM size in `vram.txt` in the FAT32 partition. By default, it uses 512MB (0x20000000) which enables [Dynamic VRAM allocation](https:\u002F\u002Felektricm.github.io\u002Famd-bc250-docs\u002Fbios\u002Fflashing\u002F#why-flash-the-bios).\n- Monitor hotswap may work, but it will not change resolution automatically.\n- Some monitors have a black screen if a video=DP-1: parameter is set in `cmdline.txt`. Confirmed working without `video=DP-1:1920x1080@60` on:\n  - MSI MAG274Q QD E2, DELL S2721DGF, DELL U2515H (1440p@60Hz)\n  - Possibly also: LG 27GL850, Lenovo Legion Y27q, ViewSonic Elite XG270QG\n\nMany configurations, tips and tricks from the [AMD BC250 Documentation](https:\u002F\u002Felektricm.github.io\u002Famd-bc250-docs\u002F) also apply to PS5.\n\n## Bugs\n\n- screen save does not work properly\n- hdmi audio output does not work on some monitors\n- hdmi 1440p and 2160p video output does not work on some monitors\n\n## Upstreamed changes\n\nDuring this project, we have upstreamed some changes:\n\n- [drm\u002Famd: fix dcn 2.01 check](https:\u002F\u002Fgit.kernel.org\u002Fpub\u002Fscm\u002Flinux\u002Fkernel\u002Fgit\u002Ftorvalds\u002Flinux.git\u002Fcommit\u002Fdrivers\u002Fgpu\u002Fdrm\u002Famd\u002Fdisplay\u002Fdc?id=39f44f54afa58661ecae9c27e15f5dbce2372892)\n- [amd\u002Faddrlib: Add more GFX1013 GPUs](https:\u002F\u002Fgitlab.freedesktop.org\u002Fmesa\u002Fmesa\u002F-\u002Fcommit\u002F44bed00b8bbcb1825e2c920cf1a828efdc72b1f1)\n\n## Discord\n\nJoin our [Discord server](https:\u002F\u002Fdiscord.gg\u002FPeMGVB7BAm) to celebrate Linux on PS5, receive help, learn tips & tricks, join development, or report issues.\n\n## Credits\n\n- [theflow](https:\u002F\u002Fgithub.com\u002FTheOfficialFloW): [ps5-linux-loader](https:\u002F\u002Fgithub.com\u002Fps5-linux\u002Fps5-linux-loader), [ps5-linux-patches](https:\u002F\u002Fgithub.com\u002Fps5-linux\u002Fps5-linux-patches), [ps5-linux-tools](https:\u002F\u002Fgithub.com\u002Fps5-linux\u002Fps5-linux-tools)\n- [c0w](https:\u002F\u002Fgithub.com\u002Fc0w-ar): [ps5-linux-loader](https:\u002F\u002Fgithub.com\u002Fps5-linux\u002Fps5-linux-loader)\n- [resulknad](https:\u002F\u002Fgithub.com\u002Fresulknad): [ps5-linux-image](https:\u002F\u002Fgithub.com\u002Fps5-linux\u002Fps5-linux-image)\n- [fail0verflow](https:\u002F\u002Fgithub.com\u002Ffail0verflow): [prosperous](https:\u002F\u002Fgithub.com\u002Ffail0verflow\u002Fprosperous)\n- [flatz](github.com\u002Fflatz): [HV exploit](https:\u002F\u002Fgist.github.com\u002Fflatz\u002F620ddda6d64acca6d1c990dc3080ac0e)\n- [cragson](https:\u002F\u002Fgithub.com\u002Fcragson): [HV expoit implementation](https:\u002F\u002Fgithub.com\u002Fcragson\u002Fps5-hen)\n- [john-tornblom](https:\u002F\u002Fgithub.com\u002Fjohn-tornblom): [PS5 SDK](https:\u002F\u002Fgithub.com\u002Fps5-payload-dev\u002Fsdk)\n- [echostretch](https:\u002F\u002Fgithub.com\u002Fechostretch): Offsets and testing\n- [kirathenotebook](https:\u002F\u002Fgithub.com\u002Fkirathenotebook): Betatesting and readme contribution\n- 15432: Tests on BC-250\n","ps5-linux 项目通过利用修补后的 HV 漏洞将运行 3.xx 或 4.xx 固件的 PS5 Phat 主机转变为功能强大的 Linux PC，充分发挥其硬件潜力以支持桌面使用。该项目基于 C 语言开发，核心功能包括利用主机的 8 核 CPU（16 线程）和高性能 GPU 来流畅运行 Steam 游戏及多种模拟器，并支持 HDMI 4K60 视频与音频输出。此外，用户还可以选择安装 M.2 SSD 作为专用的 Linux 分区，并充分利用主机的所有 USB 端口。此项目适用于希望在 PlayStation 5 上体验 Linux 操作系统并探索其强大计算能力的开发者或爱好者。",2,"2026-06-11 02:38:55","CREATED_QUERY"]