Velnode/ Docs / Vault Recovery & Backupv2.3.3-beta.15
๐Ÿ“ฆ This guide also ships inside Velnode โ€” open the โ˜ฐ menu โ†’ Help in the browser; it works offline.

Velnode

Password Vault โ€” Recovery and Backup

Velnode Browser  ·  a product of Dignity New Zealand Limited

User  |  Version 1.1  |  Last updated 2026-07-03

Velnode


Password Vault โ€” Recovery and Backup

Document type: User Owner: Dignity New Zealand Limited Applies to: Velnode Browser v1.19 and later Last updated: 2026-07-03 Document version: 1.1 Status: Approved


This guide explains how to protect the passwords and payment cards stored in Velnode's Password Vault โ€” how to set up a recovery phrase, export an encrypted backup, restore on a new computer, and enable automatic local snapshots. Everything described here is local and offline; nothing leaves your device unless you choose to copy the backup file yourself.

What you'll learn

Prerequisites


1. How the vault protects your data

Velnode's Password Vault uses two layers of encryption.

Layer 1 โ€” OS keystore. The vault file itself is encrypted by the operating system's own secure storage (Windows Credential Manager, macOS Keychain, or the Linux secret service). This means a user account that is not yours cannot read the file even if they have physical access to the drive.

Layer 2 โ€” Master passphrase. The passwords, card numbers, and sensitive fields inside the vault are additionally sealed with your master passphrase using AES-256-GCM + scrypt + RSA-OAEP (RSA-4096 for vaults created in v1.19 and later). This means that even someone who could extract the encrypted vault file would still need your passphrase to read its contents.

Your master passphrase is never stored anywhere, not on your device, not on any server. Velnode cannot recover it for you.


2. Set up a recovery phrase

The recovery phrase is a 24-word phrase (BIP39 format) that acts as a second key to your vault. With a recovery phrase in place, you can unlock the vault if you forget your master passphrase. Without it, a forgotten master passphrase is permanent and unrecoverable.

Set up the recovery phrase before you need it โ€” ideally when you first create the vault.

Steps

  1. Open the vault: click the vault icon in the toolbar, or press the keyboard shortcut shown in Settings โ†’ Vault.
  2. In the vault, open Settings (gear icon, top right) โ†’ Recovery phrase.
  3. Click Set up recovery phrase.
  4. Read the confirmation prompt and click Generate.
  5. Your 24-word phrase appears on screen. Write it down or print it now โ€” it will not be shown again.
  6. On the next screen, Velnode asks you to confirm a random selection of words from your phrase. Type each word when prompted. This confirms you recorded the phrase correctly.
  7. Once you have confirmed the words, setup is complete.

Save the Emergency Kit

After confirming your words, Velnode offers a PDF Emergency Kit. This is a printable document that contains:

Print the kit and store it somewhere physically secure โ€” a locked drawer, a fire safe, or with your other important documents. Do not store the kit only on a computer or phone, because losing the device means losing the kit.


3. Unlock the vault with the recovery phrase

Use this procedure if you have forgotten your master passphrase and you have your 24-word recovery phrase available.

  1. Open the vault. The unlock screen appears.
  2. Click Use recovery phrase (below the passphrase field).
  3. Enter your 24 words in order.
  4. Velnode verifies the phrase. If it matches, the vault opens.
  5. You are immediately required to set a new master passphrase before accessing your stored items. Choose a new, strong passphrase and confirm it.
  6. Your vault contents are now accessible under your new passphrase. The recovery phrase remains unchanged.

If you enter the recovery phrase incorrectly, the vault will not open. Check your written copy carefully โ€” BIP39 words are exact and case-sensitive only at entry (Velnode normalises case, but spelling must be exact).


4. Export a portable encrypted backup

The Backup export creates a single .velora-vault file that holds all your passwords and cards, fully encrypted. You can take this file to any computer, install Velnode, and restore your vault there.

Export steps

  1. Open the vault โ†’ Settings โ†’ Backup and restore.
  2. Click Backup (or the download arrow icon).
  3. An export dialog opens. Choose where to save the .velora-vault file โ€” a USB drive, cloud storage you trust, or a second device.
  4. Recovery-phrase option. You are offered the option to allow the recovery phrase to decrypt this backup file. If you tick this box, the exported file can be restored with either your master passphrase or your recovery phrase. If you leave it unticked, only the master passphrase can restore it.
  5. Click Export. The file is written to the location you chose.

The .velora-vault file is encrypted throughout. Its contents cannot be read without the correct passphrase (or recovery phrase, if you opted in during export). Keep the file safe; anyone with the file and the correct credential can restore your vault.

Restore steps (same computer or new computer)

  1. On the target computer, install Velnode v1.19 or later and open the vault.
  2. In the vault โ†’ Settings โ†’ Backup and restore, click Restore.
  3. Pick the .velora-vault file.
  4. A confirmation dialog warns you that restoring will replace the existing vault on this computer. Click Confirm restore.
  5. Enter your master passphrase (or recovery phrase, if you chose that option during export).
  6. Velnode decrypts and restores the vault. Your passwords and cards are available immediately.

Restoring replaces the vault. Any items added to the destination vault after your last backup will be lost. Export a fresh backup before restoring on a computer that already has a vault with recent additions.


5. Enable automatic local backups

Automatic backups save an encrypted snapshot of your vault to a folder you choose, on every change. These are tied to your current computer and are intended for local rollback (recovering from accidental deletions or a corrupted vault), not for moving data between computers. Use the portable Export for that.

Steps

  1. Open the vault โ†’ Settings โ†’ Backup and restore โ†’ Automatic backups.
  2. Toggle Enable automatic backups on.
  3. Click Choose folder and select a location. This should be a folder on a separate drive or a folder that your OS backup tool (Time Machine, File History) also picks up.
  4. Set how many snapshots to keep. The default is the last 5 snapshots. Older snapshots are deleted automatically once this limit is reached.
  5. Click Save.

From this point, Velnode saves an encrypted snapshot every time your vault changes. Snapshots are named by date and time.

Restore a snapshot

  1. Open the vault โ†’ Settings โ†’ Backup and restore โ†’ Automatic backups.
  2. The list of available snapshots is shown with timestamps.
  3. Click Restore next to the snapshot you want.
  4. Confirm the restore. Your vault is replaced by that snapshot. Enter your master passphrase when prompted.

6. If you lose both the passphrase and the recovery phrase

There is no back door. If both the master passphrase and the recovery phrase are lost, the vault cannot be unlocked by anyone, including Dignity New Zealand Limited. This is a deliberate design choice: the alternative โ€” a server-held recovery key โ€” would mean a third party can access your passwords. Velnode does not make that trade.

If you are in this situation:

  1. Accept that the vault contents are unrecoverable.
  2. In the vault unlock screen, choose Reset vault. This deletes the encrypted vault and lets you start fresh.
  3. Change the passwords for all accounts you had stored in the vault, using the "forgot password" flow on each site.

This is why setting up the recovery phrase and keeping the Emergency Kit in a safe place matters.


7. Troubleshooting

The "Use recovery phrase" link does not appear. This option only appears after at least one failed passphrase attempt on the unlock screen. Try entering the passphrase once (even if you know it is wrong) and the link will appear.

My recovery phrase was rejected. Check spelling word by word against your written copy. BIP39 words are English and are not hyphenated. Velnode accepts upper or lower case. If the phrase still fails, it may not match the vault on this computer โ€” recovery phrases are bound to the vault key generated when you set them up, not transferable between different vault installations.

The restore confirmation says "no items found in backup file." The backup file may be from an older format or from a different version of Velnode. Make sure you are on v1.19 or later. If the problem persists, e-mail [email protected] with the Velnode version shown in the title bar (or โ˜ฐ โ†’ About Velnode).

I forgot whether I enabled the recovery-phrase option when I exported. Try restoring with your master passphrase first. If that fails, try the recovery phrase. There is no way to inspect a .velora-vault file to determine which credentials it accepts without attempting a restore.

Automatic backups stopped saving. Check that the chosen folder still exists and is writable. If you moved the folder or the drive is disconnected, Velnode will silently skip the backup rather than crash. Reopen the automatic backup settings, re-choose the folder, and save.


8. Security reminders


Document maintained by Dignity New Zealand Limited. Questions: [email protected].