Skip to verification guide

Verify a Vault export

The PhotonFile verifier is a public tool for checking an encrypted file exported from Vault. With the export and its matching key, you can check the encrypted content and its structure on your own computer, then optionally decrypt a readable copy.

We publish it so you can inspect and read an exported copy outside the Desktop app. The public tools, source code, and file-format specifications make those checks open to examination. Once you have the export, key, and tools, you do not need to reconnect to your Vault to verify or decrypt that copy.

This checks a specific exported copy, not every aspect of PhotonFile's security. It does not prove who authored the file or that it is the latest revision. Choose the browser or Linux guide below to perform the same content-and-layout checks.

Verification checks the encrypted export. Decryption creates a readable copy. You do not need to decrypt it to get a verification result.

Before you begin: you need two files

Use the pair from the same completed export. A regular downloaded file or a Vault share link is not an export package. If someone already gave you both files, you can choose a guide below. You do not need to export them again.

Keep the key file private. Anyone with the package and its .key.json can decrypt that revision, even after their PhotonFile access is revoked. Treat a decrypted copy as sensitive too.

Choose how to verify

Use your browser

No verifier installation, Python, or GnuPG required. Select your two local files in the hosted application. Packages must be no larger than 256 MiB.

Processing stays in the browser tab, but the application is loaded from the live PhotonFile website.

Follow the browser guide

Install locally on Linux

For Linux x86-64 with Python 3.9+ and GnuPG. Authenticate the tools before installing them, then verify with the native command-line reader.

Use this path for packages above 256 MiB or to run authenticated tools separately from the live website. An installed local-browser option is included.

Follow the Linux guide

Need the files? Export from Desktop

Creating a verification export requires the desktop application. Receiving an existing pair does not require exporting again.

  1. Open Desktop, under advanced settings enable the verification feature, unlock your Vault, and select one current file you can download. In the selected-file actions, choose Export for verification, not Download.
  2. Read the key warning and choose a supported local destination.
  3. Keep the Vault unlocked and wait for Export completed. The dialog lists both saved file paths. Existing files are not overwritten.
  4. Confirm you have the .pfv and .key.json shown in that dialog, then choose either guide.

Expected result: two completed files whose names include the Vault and object identifiers and revision. Use the actual paths displayed by Desktop, not example filenames from a guide.

Export unavailable or interrupted?

Folders, multiple selections, legacy vault version 0 files, pending uploads, deleted items, and unsupported archive sizes are ineligible. Windows and macOS export are not currently available.

Cancelling, locking the Vault, switching accounts, or changing access context can stop an export. Do not use an incomplete pair. Preserve uncertain outputs and follow Desktop's recovery instructions. Retrying in the same destination can recover incomplete operation-owned files. Do not manually delete a completed export to clear a recovery warning.

What does a successful result mean?

Content and layout verified means the encrypted content and its structure passed the checks using the matching exported key. It does not prove who authored the file, when it existed, or that it is the latest revision.

Protected metadata, original key wrapping, and external freshness remain unverified by the public content-key reader. For example, the result does not independently authenticate the file's protected metadata or prove that the server still grants access. It is not the author's digital signature.

These are PhotonFile-published tools, not an unaffiliated audit. Read about the trust model and release evidence.

Trust, privacy, and release details

Understand the trust boundary

Desktop authenticates protected metadata, the file-key envelope, descriptor, and chunks during export. The server checks the authorized snapshot at final validation, but that does not extend authorization through local publication or revoke exported copies later.

The hosted application loads inventory-authorized files. After readiness, it makes no processing requests and does not upload selected files or keys. It uses no telemetry, marketing scripts, service workers, or persistent storage for your files and keys.

Existing website cookies may accompany initial application requests. Other same-origin code, browser extensions, or a compromised website or computer can affect confidentiality. Security headers are not an independent trust boundary. The authenticated local bundle separates processing from the live website, but still requires a trustworthy computer and browser.

Release signatures identify the PhotonFile publisher, not an independent auditor or the author of your exported file. The source archive and signed evidence identify the release's source inputs.

All release downloads, signatures, and evidence

Most users should follow one of the guides above. These links come from validated release metadata. Linux setup needs Python 3.9+ and GnuPG.

Release 0.1.5

Release primary fingerprint: 65988DFA88F70DC1704F196E19283DA08E1FEDAD. Authenticate it independently before running downloaded setup code.

Related: Vault upload and download guide, Vault security documentation, and security disclosure policy.