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.
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.
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.