Passary Logo
Passary
Early access · Manual installation

Install and pair the Passary Chrome extension

Download the current build, load it as an unpacked Chrome extension, then pair it with each Passary vault you want to use. Keep the paired vault tab open and unlocked while you use autofill.

Download Passary Extension 0.2.2
Latest release ZIPRelease notes

This early-access build is not distributed through the Chrome Web Store.

Release details

Version
0.2.2
Released
2026-07-26
Size
43.9 KiB
Filename
passary-extension-chrome-0.2.2.zip
SHA-256
c0d05c940dff9e362b889f28b49f523df0fd95d2d8b473700e981fc61b863389
Verify the download checksum (optional)

PowerShell

Get-FileHash .\passary-extension-chrome-0.2.2.zip -Algorithm SHA256

macOS or Linux

shasum -a 256 passary-extension-chrome-0.2.2.zip

Before you install

  • Updates are manual. Download the new ZIP and reload the extracted extension when a new version is released.
  • Chrome requests access to HTTP and HTTPS sites so Passary can detect login fields and fill the credential you choose.
  • Credential requests work only when the extension is paired with the matching vault and that Passary tab is open and unlocked.
  • This is an early-access build. Some sites may still need popup selection or manual entry.

1. Install in Chrome

Chrome loads this release from the extracted folder on your computer.

  1. Download passary-extension-chrome-0.2.2.zip and extract the ZIP somewhere you will keep it.
  2. Open chrome://extensions in Chrome.
  3. Turn on Developer mode in the top-right corner.
  4. Click Load unpacked, then select the extracted passary-extension folder.
  5. Optionally pin Passary to the Chrome toolbar for faster access.
  6. Reload any Passary tab that was already open so it can connect to the newly installed extension.

2. Pair with your vault

Pairing is specific to one vault and one Chrome profile. It lets that extension installation make authenticated, encrypted requests to that vault.

  1. Open Passary, unlock the vault you want to use, and keep its vault tab open.
  2. Open the Passary extension popup. Under Secure pairing code, click Copy code.
  3. In Passary, open Settings → Browser Extension Pairing.
  4. Paste the code into Pairing code from the Passary extension popup, then click Pair Extension.
  5. Wait for the vault to finish saving the pairing. Then return to the extension popup and refresh it.
  6. Confirm that the popup now says Vault connected.
This is a one-time setup for each vault and Chrome profile. Routine locking and unlocking does not require pairing again. Pair again only for another vault or profile, after reinstalling the extension or clearing its storage, or when intentionally replacing the pairing code.

3. Use the extension

Popup fill

Open the popup, confirm Vault connected, then choose a matching account to fill its username, password, and TOTP when available.

Keyboard shortcut

Quick-fill the best current match with Command+Shift+P on macOS or Alt+Shift+P on Windows and Linux.

Right-click actions

Right-click a login field, open Passary, and choose whether to fill all fields, username, password, or TOTP. You can also select a specific account.

Save and update prompts

After submitting a login on a supported site, open the popup to save a new credential or update an existing match.

4. What pairing protects

Pairing adds a private trust check between this Chrome installation and your encrypted vault.

  • A shared 256-bit keyThe extension keeps its copy in Chrome extension storage. Passary stores the matching copy inside the encrypted vault.
  • Signed, expiring requestsEvery credential request has a short lifetime and a unique value. Reused requests are rejected.
  • Encrypted responsesCredential responses are encrypted between the paired vault tab and extension instead of exposing passwords or TOTP values as plain page messages.
  • No extension-side vault copyThe extension does not store your master password, a decrypted vault, or plaintext credentials. The unlocked Passary tab remains the source of truth.

The pairing protocol uses HKDF-SHA256, HMAC-SHA256, and AES-256-GCM.

5. Limitations and troubleshooting

Current limitations

  • An unlocked paired vault tab must remain open.
  • Installation and updates are manual.
  • Unusual or heavily scripted forms may need popup selection or manual fill.
  • Passary never submits forms automatically.
  • Passkeys are not supported yet.
  • Production builds connect only to approved Passary origins.

Fix a connection or fill problem

Pairing required
Copy the popup pairing code into Passary Settings, wait for the vault to save, then refresh the popup.
Passary not connected
Confirm Passary is open at the vault screen and unlocked. Reload the extension in chrome://extensions, then reload the Passary tab.
Vault locked
Return to the matching Passary tab and unlock the vault before requesting credentials.
The installed version is stale
Remove the old unpacked build, extract the newest ZIP, and load its passary-extension folder.
A form does not fill
Try the popup account chooser and confirm the saved item hostname matches the site in the active tab.