Update firmware and database in air gapped mode

Air-gapped updates offer maximum security and control, keeping your Shell up to date without ever touching an internet-connected machine.

This page helps you locate and download the latest firmware and database for an offline upgrade of your Keycard Shell. Please read the Updating Keycard Shell in air gapped mode article as a reference for the process.

1.  Download stand-alone Shell updater app

The standalone updater app allows you to update your Shell without using internet or a web-browser. You can find it on its GitHub repository, or find the latest version below.
Check the updater's SHA256 checksum here. You can for instance use shasum -a 256 to validate the file you downloaded.
Copy the updater app to a freshly formatted USB stick. To avoid hidden malware, always format the USB drive before transferring files.

2.  Download firmware package

You can find Keycard Shell firmware releases on their GitHub repository, or find the latest version below.
Check the integrity using SHA256 checksum.
•  SHA256:
Copy to the same USB drive.

3.  Download database package

Keycard Shell uses a database to store reference information like smartcontracts ABIs, ERC-20s, and chain IDs. The process to generate this database is fully documented and reproducible. Both the process and version history are documented on the database version history page for full information. You can choose a version from this database version history, or simply pick the latest version below.
Check the integrity using SHA256 checksum.
•  SHA256:
Copy the database file to the same USB drive.

4.  Prepare offline device

Install a clean OS on an empty hard drive or external boot disk. This could be:
  • Your current machine (dual-boot or temp clean install)
  • A secondary dedicated device
Ensure it’s fully offline. Disconnect all other drives and physically disable Wi-Fi/Bluetooth if possible.

5.  Run standalone updater and follow instructions

Boot your offline machine, plug in the USB, and launch the updater.
Follow on-screen steps to update firmware and database.
Shell now runs the latest software without ever touching an internet-connected OS.

What's next?

Keep your Shell secure and up-to-date and join our community

Have questions?

Reach out to our team or engage with our community on Discord or X.

Verify authenticity of Shell

Ensure your Shell is authentic and check its verification history.

Upgrade Shell

Get the latest features and security improvements by installing the newest firmware and db.