ps5upload

PS5 Upload gets your games, apps and homebrew onto a jailbroken PS5 quickly and reliably: uploads resume after a dropped connection, installs pick the route that works, and you can browse files, manage the console and run cheats from your computer, phone or browser.

What it does

• Fast, resumable uploads of games, folders, disk images and .zip / .7z / .rar

• Install any package. PS4 .pkg and PS5 fake packages (base, update, DLC) from your

• Convert to FPKG. Build an installable package from a decrypted game folder or an

• Browse and manage. Files, games, disk images (mount, edit in place), saves, screenshots

• Cheats, fan curve, hardware view, Remote Play pairing, payload sender with a catalogue

• Power. Rest mode, reboot, shut down, and wake over the network (optionally straight

• Runs everywhere: macOS, Windows, Linux, Android, or any browser through the self-hosted

What it doesn't do

• System package patches (NPXS Store or Settings updates). Use the PS5's own

• Sign packages with fake keys. It only installs packages the console already trusts.

A quick look

Install

Pre-built downloads land on the Releases page:

| Platform | File | How to install | |---|---|---| | macOS (Apple Silicon / Intel) | PS5Upload--mac-{arm64,x64}.dmg | Open the .dmg, drag PS5Upload into Applications. See First launch on macOS below — Gatekeeper blocks downloaded apps the first time. | | Windows (x64 / ARM64) | PS5Upload--win-{x64,arm64}.zip | Unzip, double-click PS5Upload.exe — portable, no installer. See First launch on Windows — SmartScreen warns on first run. | | Linux — Debian / Ubuntu (x64 / ARM64) | PS5Upload--linux-{x64,arm64}.deb | sudo apt install ./PS5Upload--linux-.deb — installs a normal app with a menu entry; pulls in the WebKitGTK deps automatically. | | Linux — Fedora / RHEL / Bazzite (x64 / ARM64) | PS5Upload--linux-{x64,arm64}.rpm | sudo dnf install ./PS5Upload--linux-.rpm (Bazzite/Silverblue: rpm-ostree install) — menu entry + auto deps. | | Linux — any distro (x64 / ARM64) | PS5Upload--linux-{x64,arm64}.zip | Universal fallback (no install). Unzip, then chmod +x PS5Upload.sh PS5Upload.AppImage and run ./PS5Upload.sh (the wrapper — handles the FUSE-less and WebKit white-screen cases for you). Running ./PS5Upload.AppImage directly also works if your system has libfuse2 and a happy WebKitGTK. | | Linux — NixOS (x64 / ARM64) | no release artifact | Packaged in NUR as ps5upload — see NixOS below. | | Android | PS5Upload--android.apk | Enable "install unknown apps" for your browser/file manager, then open the .apk. Same interface, mobile-friendly; connects to and manages your PS5 over Wi-Fi. |

NixOS

No NixOS artifact is published on the Releases page, but ps5upload is packaged in GriefNorth's NUR as ps5upload (x64 and ARM64) — it wraps the same .AppImage and needs no FUSE. With flakes:

{
  inputs = {
    nixpkgs.url = "github:NixOS/nixpkgs/nixos-unstable";
    nur.url = "github:GriefNorth/nur-packages";
  };
outputs = { nixpkgs, nur, ... }: {
    nixosConfigurations.myhost = nixpkgs.lib.nixosSystem {
      system = "x86_64-linux";
      modules = [
        ({ pkgs, ... }: {
          environment.systemPackages = [
            nur.packages.${pkgs.system}.ps5upload
          ];
        })
      ];
    };
  };
}

Then nixos-rebuild switch --flake .#myhost and launch ps5upload from your app menu. Without flakes, call the package straight out of the repo — and note that ps5upload bundles UnRAR for .rar support, so nixpkgs needs config.allowUnfree = true:

{ pkgs, ... }:
{
  nixpkgs.config.allowUnfree = true;
environment.systemPackages = [
    (pkgs.callPackage
      ((builtins.fetchTarball
        "https://github.com/GriefNorth/nur-packages/archive/refs/heads/main.tar.gz")
        + "/pkgs/ps5upload")
      { })
  ];
}

Or try it without installing anything:

nix run github:GriefNorth/nur-packages#ps5upload

The Nix expression pins one release version, so bump it there when a new ps5upload comes out. Prefer to run the AppImage yourself? Prefer the ./PS5Upload.sh wrapper from the zip above — on NixOS the bare .AppImage usually renders an empty window, because its bundled libwayland-client shadows the host one and WebKitGTK then fails to create an EGL display. The Nix package works around that for you.

First-launch warnings (and why they're there)

ps5upload is not code-signed with paid OS certificates — same as every other PS5 scene tool. The OS's verification layers (Gatekeeper on macOS, SmartScreen on Windows) treat unsigned downloads as suspicious until you allow them once. The one-time bypass:

macOS — "App is damaged" or "cannot be opened":

xattr -dr com.apple.quarantine /Applications/PS5Upload.app

Windows — "Windows protected your PC" SmartScreen prompt:

• Click More info → Run anyway.
• Only shown until SmartScreen builds reputation for the binary;

• If your IT policy blocks "Run anyway", unzip + right-click

Linux — no equivalent warning. Just chmod +x and launch.

System requirements

• macOS 11 (Big Sur) or newer. No dependencies — ad-hoc signed,

• Windows 10 (build 19041+) or Windows 11. Ships with the

• Linux — the .deb and .rpm packages **pull in their

The app checks GitHub for updates once per launch (Settings → Updates) and downloads a fresh archive to your Downloads folder when you click Download. Replace the old app and relaunch; the app then offers to update the helper.

Building from source:

git clone https://github.com/phantomptr/ps5upload.git
cd ps5upload
make install       # bootstrap dev env (auto-detects host OS)
make build         # payload ELF + engine + client UI
make run-client    # launch the Tauri dev app

make install auto-detects your OS and runs one of:

• make install-ubuntu — Debian / Ubuntu / WSL2: apt deps for Tauri

• make install-macos — macOS: Xcode CLT, Homebrew, node, current

• make install-windows — Windows 11: Node.js LTS, Rust, VS 2022 Build

All three install scripts are idempotent — re-running them after a partial setup is safe. A stale or unmarked SDK is upgraded to the repository pin and moved to a timestamped backup instead of being deleted. Local and GitHub Actions builds read the same tag and official release checksum from scripts/ps5-sdk.env.

For per-platform bundles only (no full dev env): make dist-mac, make dist-mac-x64, make dist-linux, make dist-linux-arm, make dist-win, and make dist-win-arm.

Quick start

1. Jailbreak the PS5 and keep an ELF loader running on port 9021.
2. Launch ps5upload and open Connection. Enter the PS5's IP address.
3. Click Check, then Send payload. The app launches the helper and pairs with it by

1. If you loaded the helper another way, the console shows a 6-digit code. Enter it in the

The helper stays until the PS5 reboots or enters rest mode. The app only needs ports 9120 (the helper) and 9021 (the loader); allow both in your firewall. 6.0 cannot talk to a v5.x helper: the app offers Update the helper and replaces it in one click.

Architecture

client/ (Tauri 2 · React · TypeScript)   Android app · Docker web UI
   │
   └── spawns ── ps5upload-engine (HTTP :19113)
                          │
                          ▼  AVA1 (Noise-encrypted, port 9120)
                payload/ps5upload.elf  (PS5 C payload)

• payload/: C payload on the PS5 (FreeBSD 11). Transfers, BLAKE3 verification, mounts,

• engine/: Rust workspace with the AVA1 client, transfer logic, HTTP API and lab tools.
• client/: Tauri 2 desktop app (and the Android and web builds), talking to the engine.

Build and test

All workflows go through the root Makefile (make help).

| Command | What it does | |---|---| | make build | Payload + engine + client | | make run-client | Tauri dev app | | make run-engine | Engine on localhost:19113 | | make test-engine | Rust tests, no PS5 needed | | make test-payload | Console C code compiled and run on the host | | npm run validate | Full non-hardware gate | | make dist | Tauri bundle |

See TESTING.md for the full workflow, and CONTRIBUTING.md.

Tech stack

• Payload: C (FreeBSD 11), prospero-clang, PS5 Payload SDK v0.43
• Engine: Rust, tokio + axum
• Client: Tauri 2, React, TypeScript, Zustand, Tailwind CSS v4, Vite
• Protocol: AVA1 (Noise XX handshake, ChaCha20-Poly1305, BLAKE3 verification)

Supported platforms

• Desktop: macOS, Linux and Windows, x64 and arm64.
• Android: the .apk from Releases.
• Web UI: the self-hosted Docker image, in any browser on your LAN (see below).
• PS5 firmware: 1.00 through 13.60 on every model; one payload binary for all. Tested on

Fake package install needs live kernel patches (kstuff / fpkg-enable) on the console; where they are missing the app says so instead of reporting a false success.

Self-hosted engine and web UI

Run the engine on a NAS or server and use it from a browser, or point the desktop app at it with Settings → Engine URL.

• Images: ghcr.io/phantomptr/ps5upload-engine-webui (full web UI) and

• Start from engine/compose.yaml. It uses host networking (stream

• Open http://:19113. The file picker browses the engine's disk; mount your games

• An upload keeps running when you close the tab.
• No password. Anyone allowed can read, write and delete on your PS5. Keep it on a trusted

• You may build the docker container with the PS5UPLOAD_BASE_URL to host the webui through a

FAQ

Common questions (connection problems, install errors, USB drives, firmware) are in FAQ.md, also available inside the app.

Contributing

• Report bugs:

• Pull requests welcome. Read CONTRIBUTING.md and run the checks in

Disclaimer

**ps5upload is provided for research, educational, interoperability,

and homebrew development purposes only.** It is not affiliated with,

endorsed by, or connected to Sony Interactive Entertainment Inc.

"PlayStation", "PS4" and "PS5" are trademarks of Sony Interactive

Entertainment Inc., used here for identification only.

> Use this software entirely at your own risk. It is provided

"as is", without warranty of any kind, express or implied,

including but not limited to warranties of merchantability, fitness

for a particular purpose, and non-infringement.

➡ Full terms: DISCLAIMER.md. By downloading, building, installing, or using this software you accept them in full. If you do not agree, do not use it.

You are solely responsible for how, where, and on what hardware you use this tool. By downloading, installing, or running it, you acknowledge and accept that:

• It interacts with a modified PS5. This tool only works on a

• **It writes to your PS5's filesystem and can install / register

• **It is intended for use only with content you legally own and

• No support is guaranteed. This is a free, volunteer-built

• No piracy. This tool must not be used to copy, distribute, or

• You accept the real risks. Operating a modified console can

• Indemnity. You agree to hold the authors, contributors, and

If any of the above is not acceptable to you, do not use this software.

Third-Party Libraries

This software builds on the following open-source projects:

Desktop client (Tauri 2 + React):

• Tauri — Rust-backed cross-platform desktop runtime
• React — UI library
• Zustand — Client state management
• Tailwind CSS — Styling
• Vite — Build + dev server
• lucide-react — Icons
• react-router — Routing

• tokio — Async runtime
• axum — HTTP service
• serde — Serialization
• anyhow — Error handling
• uuid — Job IDs
• zip + sevenz-rust2 — pure-Rust .zip / .7z extraction

Payload (PS5):

• PS5 Payload SDK — Open-source SDK for PS5 payload development
• elfldr (GPLv3) — the ELF loader; a patched copy is vendored at third_party/elfldr (fix for a loader that hangs on a silent client)
• Monocypher (CC0 / BSD-2) — AVA1's cryptography on the console (X25519, ChaCha20-Poly1305, BLAKE2b)
• BLAKE3 (CC0 / Apache-2.0) — fast hashing for AVA1 file verification
• SQLite (public domain) — reading the console's app database
• tiny-AES-c (Unlicense) — MC4 cheat decryption

Thanks

• elf-arsenal (soniciso, Sanad) — parts of the drive sensor, cheat and wake-watchdog code
• PROSPEROPatches, ORBISPatches and TMDB — game details and artwork
• etaHEN PS5_Cheats and GoldHEN — cheat files
• Everyone who contributed code, translations and docs, and the Discord testers

License

GNU General Public License v3.0 (GPLv3). Free to use, free to modify. See LICENSE.

.rar support / UnRAR: the desktop build bundles the UnRAR source (used only to extract RAR — never to compress or build a RAR-compatible archiver). A GPLv3 §7 linking exception covers combining it with this GPL code, and UnRAR's own license is reproduced as required. See LICENSES/UnRAR-exception.md and LICENSES/UnRAR-license.txt.

Author

Created and maintained by PhantomPtr.

• Follow me on X (@phantomptr)

Support

If you find this tool useful, consider buying me a coffee!

• Discord server: https://discord.gg/fzK3xddtrM
• Support me on Ko-fi: https://ko-fi.com/B0B81S0WUA