Skip to Content
All Posts

Security · 6 min read

What Is a Duress Passcode, and When Would You Use One?

A duress passcode opens an empty vault and silently erases the rest when someone forces you to unlock. How it works, when it helps, and when to skip it.

Siddharth Pereira, Co-Founder, ProductBy Siddharth PereiraUpdated
Close portrait of a bearded young man looking straight at the camera in darkness.

Key Takeaways

  • A duress passcode is a second passcode that looks like a normal unlock but protects your data when someone forces you to open an app.
  • In HypaVault, the duress passcode destroys every other vault's keys in one silent step and opens an empty vault, with no decoy files to set up.
  • Erased vaults come back only from a backup and its recovery phrase, so back up every vault before you rely on a duress passcode.
  • A border crossing is the wrong place for one: U.S. Customs and Border Protection says travelers must present devices in a condition that allows examination.
  • A duress passcode protects HypaVault's vaults only, not your messages, photo library or other apps.
In This Post

A duress passcode is a second passcode you enter when someone forces you to unlock. In HypaVault, it looks like a normal unlock, silently erases every other vault on the phone and opens an empty one. It's built for the moment a lock screen can't help: when the person demanding access is standing next to you.

What Is a Duress Passcode?

Encryption protects files from anyone who doesn't know the passcode. It does nothing when you're the one made to type it. A duress passcode lets you comply on the surface while the real data becomes unreadable.

With Pro, you can turn on HypaVault's Duress Passcode. You choose a second 6-digit passcode, and HypaVault sets aside an empty vault for it. From then on, the lock screen treats that code like any other passcode, with one difference in what happens next.

It also differs from wiping the whole phone. A factory reset takes time, runs through menus and is obvious to anyone watching. A duress passcode works from the lock screen in the time it takes to type six digits, and it touches only HypaVault.

What Happens When You Enter a Duress Passcode

  • The lock screen accepts it like any other passcode. Nothing on screen looks different.
  • In one silent step, HypaVault destroys the keys of every other vault on the phone. Without those keys, nobody can decrypt their files again.
  • HypaVault then deletes the files in the background.
  • The empty vault opens, showing no sign of duress.

Technically, one write overwrites every other vault's key slot with random bytes. HypaVault keeps four key slots on every phone, and they look identical whether they're used or not. So nothing on the phone points to the vaults that were there. The security page covers the details.

Flow showing what a duress passcode does in HypaVault: you type it like any other passcode, the keys of every other vault are destroyed in one write, their files are deleted in the background, and an empty vault opens with no sign of duress.
The erase happens before the empty vault appears, in a single step you can't see.

Erase or Decoy: Why the Vault Is Empty

Some tools offer a decoy instead of an erase. In crypto, BIP39 passphrases work this way: every passphrase opens a valid wallet, but only the right one opens yours. The real wallet survives, hidden behind a different input.

HypaVault takes the other approach. There's no decoy setting to fill; the vault it opens is empty. Once the keys are gone, nobody can open the erased vaults on that phone, including you if the pressure continues later. The trade-off is plain: your backups become the only way back.

When a Duress Passcode Makes Sense

A duress passcode fits moments when refusing isn't safe and someone wants into HypaVault specifically. Think of a robbery, a controlling partner or relative, or anyone who already knows the vault exists. It works best alongside the other layers, each of which covers a different risk.

What each protection covers
ProtectionHelps WhenDoesn't Help When
Phone passcodeSomeone finds or steals a locked phoneYou're made to unlock it
Stolen Device Protection on iPhoneA thief knows your passcode and the phone is away from familiar placesYou're the one being made to unlock
Stealth ModeSomeone glances at your apps and sees a calculator or clockSomeone already knows the vault is there
Additional VaultsYou keep parts of life apart, with none showing the othersSomeone insists on a vault they know about
Duress passcodeYou're forced to open HypaVaultIt's typed by mistake, or you have no backup

For the disguise layer, see how a calculator vault works. For separate vaults that stay invisible to each other, see Additional Vaults.

A Robbery or Mugging

Your safety comes first, so hand over what's demanded. A duress passcode lets you do that without exposing what's inside HypaVault. To the person watching, the app simply opens.

A Controlling Partner or Relative

Someone close to you may know your habits and notice an empty vault. Apple's Personal Safety User Guide makes the same point about any change to a phone: others may notice changes to sharing or access. It also suggests recording suspicious activity first.

So if a vault holds evidence you may need later, keep a backup somewhere the other person can't reach. The erase removes it from the phone, but the backup keeps it.

Someone Who Already Knows the Vault Exists

Stealth Mode stops helping once someone knows the calculator is really a vault. That's the moment a duress passcode is for.

When Not to Use It: Border Crossings

A border is the clearest case for leaving a duress passcode alone. U.S. Customs and Border Protection says travelers must present devices in a condition that allows examination. CBP can detain a device it can't inspect.

The EFF's border guide advises travelers to be courteous and not to lie. It also warns that unusual precautions may make agents suspicious, and wiping data in front of an officer is about as unusual as it gets. The guide dates from 2018 and rules differ by country, so check current advice before you travel.

Device searches are rare, though. In fiscal year 2025, CBP searched the devices of 55,318 travelers out of more than 419 million it processed. Most of those were basic searches.

U.S. border device searches in fiscal year 2025: over 419 million travelers processed at U.S. ports of entry, 55,318 travelers whose devices were searched, about 0.013 percent of travelers processed, and 92 percent of those searches basic rather than advanced.
Figures from U.S. Customs and Border Protection for fiscal year 2025.

A Safer Plan for Travel

The EFF suggests carrying less data across the border instead. HypaVault lets you do that openly:

  1. 1Before you leave, tap Back Up Now and save the .hypa file somewhere off the phone.
  2. 2Delete the files you won't need on the trip. Deleting in HypaVault is permanent, so make the backup first.
  3. 3After the trip, choose Restore from Backup and enter the vault's recovery phrase. Restore adds back what's missing.

How to Prepare Before You Turn It On

A duress passcode is only as safe as your backups. Put these in place before you rely on it.

  1. 1Back up every vault with Back Up Now and keep each file off the phone.
  2. 2Write each vault's 12-word recovery phrase on paper, and keep it apart from the backups.
  3. 3Choose a duress passcode that's nothing like your everyday passcode.
  4. 4Back up again when HypaVault reminds you. The reminder appears once your last backup is more than 14 days old.

The code itself takes some thought. It should be one you'd never type by habit but can still recall when your hands are shaking. Avoid your everyday passcode with one digit changed, since a slip of the thumb could trigger it. Rehearse it in your head, never on the phone.

The guide Prepare a Duress Passcode Before You Need It walks through each step.

Getting Your Vaults Back Afterwards

Erasing is permanent on the phone, but your backups still work. To restore an erased vault, choose Restore from Backup, pick its .hypa file and enter that vault's recovery phrase. Restore adds back what's missing and removes nothing.

You get back what the vault held when you made the backup. Anything added since then is gone, which is why a regular backup routine matters as much as the duress passcode itself.

What a Duress Passcode Can't Do

  • It erases HypaVault's other vaults, not the rest of your phone. Your messages, photo library and other apps stay as they are.
  • It can't stop anyone who has your recovery phrase from opening your backups.
  • It can't protect against malware on the phone or someone watching your screen.
  • It can't undo itself. Only a backup brings an erased vault back.

If Pro ends, an existing duress passcode keeps working, so the protection you set up stays in place.

References

  1. 1.BIP39: Mnemonic code for generating deterministic keys · Bitcoin Improvement Proposals (GitHub)
  2. 2.About Stolen Device Protection for iPhone · Apple Support
  3. 3.Safety considerations (Apple Personal Safety User Guide) · Apple Support
  4. 4.Border Search of Electronic Devices at Ports of Entry · U.S. Customs and Border Protection
  5. 5.Things to Consider When Crossing the U.S. Border · Electronic Frontier Foundation, Surveillance Self-Defense
Siddharth Pereira, Co-Founder, Product

About the Author

Siddharth Pereira · Co-Founder, Product

Siddharth Pereira co-founded the company behind HypaVault and runs its product roadmap. He has spent more than 18 years building digital products, with a focus on product strategy and product management. Here he writes about how phone privacy works in practice: encryption, backups and the settings that matter.

Questions About This Post

A lock screen protects you from strangers, not from someone standing over you. Here's what a duress passcode does, where it helps, and where it can backfire.

  1. It unlocks like a normal passcode, but in HypaVault it silently erases every other vault on the phone and opens an empty one. Nothing on screen shows that duress was used.

    Read the Help Article
  2. It erases them. HypaVault destroys the other vaults' keys, so their files can never be decrypted again, then deletes the files in the background.

    Read the Help Article
  3. Yes, from a backup. Restore each vault's .hypa file with that vault's recovery phrase, and you get back what it held when you made the backup.

    Read the Help Article
  4. It's the wrong tool there. U.S. Customs and Border Protection says travelers must present devices in a condition that allows examination, so carrying less data is the better plan.

  5. It erases your other vaults just the same. Choose a code that's nothing like your everyday passcode, and keep your backups current.

    Read the Help Article
  6. No. It erases HypaVault's other vaults only. Your messages, photo library and other apps aren't affected.

  7. No. The vault it opens is empty, and there's no decoy setting to fill in.

    Read the Help Article
  8. Setting one up needs Pro. If Pro ends later, an existing duress passcode keeps working.

    Read the Help Article

Keep Reading

All Posts