Boosting Trezor Model T Security with SD-Protect & Wipe Pin (Full Guide + Install TrezorCTL)
If you use a Trezor Model T and care about protecting it from physical key-extraction attacks, this guide is for you. The Model T firmware adds two useful security features: SD-Protect and a wipe PIN. Both require the Trezor command-line utility, TrezorCTL, to enable or configure.
You can follow along with the full walkthrough here: Watch the video.

These features are not for casual users. They add real protection, but they also add complexity: if you lose the SD card or forget your PIN, you still need your recovery seed to restore funds. That trade-off is worth understanding before you enable anything.
What You Need Before Starting
Before touching TrezorCTL, make sure you have:
- A Trezor Model T. This guide does not apply to the original Trezor One.
- A computer with internet access.
- An SD card if you want to use SD-Protect.
- Your recovery seed safely backed up and verified.
- Basic comfort using a terminal or command prompt.
For SD-Protect, the SD card needs to be formatted in a compatible way: FAT32 with an MBR partition table. On Windows, cards of 32 GB or smaller are usually the easiest to work with for this purpose.
If you only want to install TrezorCTL and set a wipe PIN, you do not need an SD card yet.
Install Python First
TrezorCTL is installed through Python’s package manager, pip. So the first step is installing Python on your computer.
- Go to python.org and open the Downloads page.
- Download the current Python release for your operating system.
- Run the installer.
- On Windows, make sure you tick “Add Python to PATH” during installation.

That last step matters. If Python is not added to your system path, you may not be able to run python or pip easily from a command prompt.
Once installation finishes, open your terminal and check that Python works:
python --version
You should see a Python 3 version number printed back at you. If it does not work, fix the PATH issue before moving on.
Install TrezorCTL with pip
With Python installed, installing TrezorCTL is straightforward. Open a terminal and run:
pip install trezor
This will download the Trezor Python library and its dependencies. When it finishes, you should see a success message indicating that the trezor package was installed.

From here on, the process is basically the same whether you are using Linux, macOS, or Windows. The main difference is how you open a terminal and what exact commands your shell uses.
Install Trezor Bridge and Detect Your Device
TrezorCTL needs a way to talk to your device over USB. The easiest option is Trezor Bridge.
- Download and install Trezor Bridge from the official Trezor sources.
- Plug in your Trezor Model T by USB.
- Unlock the device on its screen.
This last step is important: a locked Trezor Model T may not expose the USB data connection properly, so trezorctl list may return nothing if the device is still locked.
Once the device is unlocked and detected, run:
trezorctl list
You should see your Trezor listed in the output. The exact wording can vary depending on whether it connects through Bridge or another USB method, but what matters is that TrezorCTL can now see the device.

If you get an error or no result, wait a moment and try again. In some environments, especially virtual machines, device detection can be slower than expected.
Enable SD-Protect on Your Trezor Model T
SD-Protect makes your SD card part of the unlock process. Once enabled, the device will not fully unlock without the correct SD card present.
To enable it:
- Make sure your Trezor is connected and unlocked.
- Run the following command in your terminal:
trezorctl device sd-protect enable
- Confirm the prompt on the Trezor screen.
- Insert a compatible SD card if the device asks for one.

At this point, your device should report that SD card protection has been enabled.
Format Your SD Card Correctly
If the SD card does not work, formatting is usually the issue. The card needs:
- FAT32 file system
- MBR partition table
- A size that your OS can format easily as FAT32; on Windows, 32 GB or smaller is typically the safe choice
To format it in Windows:
- Insert the SD card into your computer.
- Open File Explorer and right-click the removable drive.
- Choose Format.
- Select FAT32 as the file system.
- Confirm that you want to erase all data on the card.
Be careful: formatting wipes everything on the SD card. If it contains anything important, back it up first.
After formatting, reinsert the card into your Trezor and test unlocking again. If the format is correct, the device should accept the card without issue.
Test SD-Protect and Power-Cycle Properly
Once SD-Protect is enabled, you can verify that it actually works:
- Unlock the Trezor normally with the SD card inserted.
- Remove the SD card while the device is still powered on.
- Lock the device or trigger an unlock attempt without the card.
You should see an error saying that SD-Protect is enabled and the SD card is required. That means the protection is working as intended.
One practical detail: if you remove and reinsert the SD card while the device is running, it can freeze or behave oddly. The reliable fix is to power-cycle the Trezor:
- Unplug the USB cable.
- Wait a few seconds.
- Plug it back in.
- Unlock normally with the correct SD card inserted.
This avoids the kind of stuck state you can get when hot-swapping the card while the device is active.
Disable, Refresh, and Understand the Salt File
SD-Protect stores a small piece of random data on the SD card. The Trezor wiki calls this a salt file. Without that file, the device cannot complete its normal unlock process with your PIN.
Disabling SD-Protect
If you want to turn it off:
- Connect and unlock your Trezor.
- Run:
trezorctl device sd-protect disable
- Confirm on the device screen.
Your Trezor returns to normal operation, and the SD card is no longer required for unlocking.
Refreshing SD-Protect
Refreshing replaces the random data stored on the card with a new value. This is useful if you suspect someone may have copied or stolen your old salt file.
To refresh:
- Connect and unlock your Trezor.
- Run:
trezorctl device sd-protect refresh
- Confirm the prompt on the device.
After a refresh, any previously copied salt data is no longer valid for unlocking your device.
What Is Stored on the SD Card?
If you open the SD card in File Explorer, you will typically see:
- A folder named
trezor - Inside that, a folder based on your specific Trezor’s device ID
- Inside that folder, the salt file

This structure has two important implications:
- One SD card can support multiple Trezor Model T devices, because each device uses its own folder.
- Anyone who copies that folder to another card could use it with your PIN to unlock your specific device.
That does not mean the salt file alone is as sensitive as your seed phrase or passphrase, but it is still part of the unlock chain now. Treat it accordingly: do not leave it lying around on shared computers, cloud drives, or untrusted cards.
Set a Wipe PIN with TrezorCTL
The second major feature in this firmware update is the wipe PIN. If you enter this special PIN during unlock, the device resets itself.
To set it:
- Make sure your Trezor is connected and unlocked.
- Run:
trezorctl device wipe-code set
- Confirm the prompt on the device screen.
- Enter your existing PIN first.
- Choose a new wipe PIN that is different from your normal PIN.
- Re-enter it to confirm.

Once set, entering that wipe PIN during unlock will reset the device immediately. The screen will tell you what happened, so it should not be mysterious later why the wallet appears empty.
Wipe PIN Behavior and Recovery Notes
A wipe PIN is powerful because it gives you a fast way to neutralize a compromised or lost device. If someone has physical access and tries your wipe PIN instead of your real PIN, the Trezor wipes itself.
But there are two important caveats:
- You still need your recovery seed to restore funds after a wipe.
- A wipe PIN does not protect you if an attacker already knows your normal PIN or can extract keys through other means.
SD-Protect works differently. It adds friction against physical attacks by requiring the SD card as part of the unlock process. If you lose the card, forget your PIN, or make a mistake, you can still use the normal recovery path: wipe the device and reinitialize it from your seed.
That is why this setup makes the most sense for experienced users who already understand seed backup, passphrases, and recovery procedures. It gives you extra protection without replacing the core security model of the wallet.
Final Thoughts
SD-Protect and a wipe PIN are meaningful upgrades for Trezor Model T owners who want stronger defenses against physical key-extraction attacks. They are not magic, and they do increase operational complexity. If you enable them, make sure your recovery seed is backed up properly, stored safely, and tested.
If you need help with wallet access or recovery after a wipe, lost PIN, or SD card issue, you can also check out the recovery services and consultations page.
Questions from viewers
Common questions from the comments on this video, with my answers.
What happens if I lose or corrupt the SD card used for SD-Protect?
If you lose or damage the SD card, you cannot access your crypto directly through the device. However, you can still recover your funds by wiping the Trezor to its factory state and re-initializing it with your recovery seed phrase. Once the device is reset, you can re-enable SD-Protect if you wish.
Does SD-Protect actually prevent key extraction attacks if the attacker has my PIN but not the SD card?
Yes. The keys on the device are encrypted using a combination of your PIN and random data stored on the SD card. Without the physical SD card, an attacker cannot decrypt the extracted data, even if they know your numeric PIN. This effectively adds a massive layer of complexity to any brute-force attempts.
Do I need to keep the SD card inserted in the device at all times?
No, and you shouldn't. If you leave the SD card in the device permanently, it doesn't provide much protection because an attacker who steals the device would also steal the card. For maximum security, you should remove the card when not in use. When the card is removed, the device will not unlock, and your computer won't even recognize it as connected until you insert the correct card and enter the PIN.
Can I use SD-Protect alongside other security features like a BIP-39 passphrase or Wipe PIN?
Yes, you can use all these features together. SD-Protect does not interfere with the standard functionality of the device or your backups. You can still use a BIP-39 passphrase and set up a Wipe PIN (which works on both Model T and One) while having SD-Protect enabled.
I'm getting an error saying 'TrezoretlGroup' object has no attribute 'resultcallback' when running trezorctl. How do I fix this?
This issue occurs because the current version of the `click` package is incompatible with the Trezor libraries. To fix it, you need to force the installation of a lower version of the click package. You can do this by running the command: `pip3 install "click<8"` (or checking the specific pinned version recommended in the Trezor firmware issues). (Apps and tools change, so check the current version if something looks different.)
Is there a version of this guide for the original Trezor One?
The process for installing the command-line tools (TrezorCTL) is the same for the Trezor One. However, please note that the Trezor One does not support the SD-Protect feature; that feature is exclusive to the Model T. The Wipe PIN feature does work on the Trezor One.
Stuck with a wallet recovery?
I maintain BTCRecover and have helped people recover seed phrases, passphrases and wallet passwords since 2019. Book a one-hour video session and I'll walk you through doing the recovery yourself, without sharing your seed. Or, if you'd rather I run it, a trusted recovery is charged only if it succeeds.
Private sessions: US$100 per hour. Trusted recovery: 10% of recovered funds. I never contact people first and will never ask for your seed phrase over chat or email.
Found this useful?
These guides are free and ad-free. You can support them by sharing them, subscribing on YouTube, or sending a tip.







