padloc/docs/checksums/linux/README.md

2.8 KiB

Checksums (Linux)

We use file checksums (SHA-256) to verify the source code you see matches the code served by our app. These are instructions for you to verify that too, so you don't have to trust us.

NOTE: These commands are meant for Linux and should also work on macOS. For Windows systems, we suggest you run them via WSL2.

Verify checksums against source code

Unfortunately, because we sign our Linux builds (both via Electron and Tauri), it's not really possible to locally build the exact same file unless you had access to our certificates and keys. You can still see how we build them here (via Electron and via Tauri), and see how to build unsigned ones yourself (via Electron and via Tauri) , though.

Verify what you're using has the same source code

  1. Download the Electron or Tauri AppImage or deb file.

    You can do that from our releases page or from the store you've downloaded it from, to make sure that wasn't tampered with in the process of uploading there.

  2. Download the latest sha256sum-[tauri/electron]-[appimage/deb].txt checksum file:

    NOTE: Pick one of the options above, from tauri or electron, and from appimage or deb, depending on what's available for that platform. You can see what's available in the releases page. For the examples below, we'll use tauri and appimage.

    wget https://github.com/padloc/padloc/releases/latest/download/sha256sum-tauri-appimage.txt
    
  3. Verify checksum matches:

    sha256sum -c sha256sum-tauri-appimage.txt
    

    You should see the .AppImage filename with an OK next to it for matching checksums. You'll get a warning at the end of the script if something didn't match.

    NOTE: If there's a warning about failing to find a file, your .AppImage file probably doesn't match what sha256sum-tauri-appimage.txt expects, so you can change your .AppImage file's name to padloc_4.0.0_amd64.AppImage (or whatever's in the file) for it to be found.

    Here's an illustrative example of success:

    ./padloc_4.0.0_amd64.AppImage: OK
    

    And one with a tampered file:

    ./padloc_4.0.0_amd64.AppImage: FAILED
    sha256sum: WARNING: 1 computed checksum did NOT match