The Fireblocks workspace key backup process ensures you maintain independent access to your workspace's full private key, which is required to recover your assets from your Fireblocks Vault if the Fireblocks service is disrupted.
Note: Cold Wallet workspaces can now generate workspace key backups directly from the Console, without requiring workspace Owner approval or opening a support ticket. See Cold Wallet Workspace Key Backup.
Overview
When you use Fireblocks MPC wallets, you keep direct custody of your assets. As your own self-custodian, you are responsible for ensuring independent access to your private key. Backing up your workspace's full private key maintains access to your assets even if the Fireblocks service is disrupted.
The two Cloud key shares of your workspace's full private key are stored across separate Fireblocks data centers. Generating a backup gives you full control over your workspace's full private key outside of Fireblocks infrastructure.
Fireblocks recommends backing up your key shares within 14 days of your workspace creation date. A reminder appears in the Fireblocks Console after you enroll your first mobile device.
Download the Recovery Utility
To run the Fireblocks Recovery Utility application, download it by selecting the link for your operating system:
- MacOS (M1/M2 Chips)
- Ubuntu 20.04 LTS (the only supported Ubuntu version)
The application contains both the Recovery Utility and the Recovery Relay. The Recovery Relay is used as part of the asset withdrawal process.
- Run the Recovery Utility on an air-gapped machine (as described in Generating a key backup package).
- Run the Recovery Relay on an online machine to enable withdrawals, if needed.
Start the backup process
- Download the Fireblocks Recovery Utility for your operating system.
- Set up the offline recovery machine. The machine must be air-gapped and offline.
- Transfer the Recovery Utility app to the offline machine (for example, using a USB stick).
-
Select Use the Recovery Utility > Generate Keys, then follow the on-screen instructions to generate your key backup package.
Note: If your machine is not offline, a red warning message appears at the top of the Recovery Utility app window indicating you must go offline.
- Generate the recovery key pair:
-
Enter a private key passphrase of at least four characters, then select Generate Recovery Keys. Save this passphrase; you will need it to construct the full package.
- Select Download Keys Zip to download your Private Key (save this on your air-gapped machine) and your Public Key for uploading to the Fireblocks Console in the following steps.
- Extract the Public Key from the zip file to an online machine, then contact Fireblocks Customer Success for assistance.
-
Send your recovery public key to Fireblocks
- Copy the public key file (fb-recovery-pub.pem) to an online machine.
- On the online machine, calculate the MD5 checksum of the public key:
- If your online machine runs Windows:
- Open Command Prompt or Windows PowerShell.
- Locate the folder containing the public key (fb-recovery-pub.pem).
- Enter cd followed by the folder path. You can drag and drop the folder to fill in the path automatically.
- Enter the following command:
- Press Enter. The output is the MD5 checksum of the public key file.
- If your online machine is a Mac:
- Open Terminal.
- Locate the folder containing the public key (fb-recovery-pub.pem).
- Enter: md5 <fb-recovery-pub.pem>. You can populate the filename automatically by dragging the file from Finder into the Terminal window.
- Press Enter. The output is the MD5 checksum of the public key file.
- If your online machine runs Windows:
- Use the inputs below to complete the task form and send your recovery public key and checksum to Fireblocks Support:
- CC: If you are not the workspace Owner, add their email address here.
- Tasks: Select Workspace Operations.
- Workspace Operations: Select New workspace keys backup - performed by my organization.
- Confirm Passphrase: Select this checkbox to confirm you have the Owner's recovery passphrase.
- Owner's Approval: Indicate whether you are the Owner, or if you CC'd them.
- I have attached the Public Key: Select this checkbox (you attach the key in a later field).
- MD5 Checksum: Paste the MD5 checksum you generated.
- Workspace name(s): Enter the names of your associated workspaces.
- Business Impact: Select Low, Medium, High, or Critical based on urgency.
- Subject: Enter a subject line.
- Description: Paste your recovery public key as part of your description.
- Attachment: Attach your public key file (fb-recovery-pub.pem), which you previously moved to an online machine.
- Fireblocks Support performs an integrity check to validate your public key and emails you a Workspace Keys Backup package per the Fireblocks Recovery Services SLA.
When you receive the recovery kit from Fireblocks, move it to the offline device. Verify the package using the Recovery Utility.
To reconstruct your workspace, see Reconstructing your workspace.