# Emergency Password / PIN

{% hint style="info" %}
BitBanana v0.9.7 or newer is required
{% endhint %}

An emergency password or PIN is designed for situations where you are being forced to unlock your wallet by someone else. If you enter this emergency password or PIN instead of your regular one, BitBanana will appear to unlock normally while quietly performing additional protective actions. Depending on your chosen emergency mode, it may erase all your connections or show only a wallet with a small amount of funds.

{% hint style="info" %}
When the app is unlocked with an emergency password or PIN, the <mark style="background-color:orange;">Settings → App Lock</mark> screen will show as if no emergency unlock is configured. This is intentional to ensure an attacker cannot detect if you have set up an emergency unlock.
{% endhint %}

{% hint style="warning" %}
It’s a good idea to make a backup and test it once or twice after setup so you’re comfortable using it.
{% endhint %}

## Emergency Modes

### Erase all

In this mode, the emergency unlock will delete all connections and contacts, making the app look like a fresh install. Keep in mind that if the person forcing you to unlock the app knows you have funds, they may become upset or suspicious when they see everything wiped.\
If you use this method, it's a good idea to create backups regularly so you can easily restore them later if needed.

### Show selected wallet only

This mode is designed for users who have multiple node or wallet connections in BitBanana. When using the emergency unlock, BitBanana will show only the specific connection you’ve selected in the settings while hiding all other connections and all your contacts. A good practice is to have a connection to a hosted wallet with just a small amount of sats. This way, you can provide the attacker with a minimal balance while keeping your other connections/wallets hidden.

{% hint style="warning" %}
If you change or remove your password, PIN, emergency password or emergency PIN while the app is unlocked using this emergency method, all contacts and all connections except the one used for display will be deleted. This ensures that an attacker cannot simply remove the PIN and gain access to all your connections.
{% endhint %}


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://docs.bitbanana.app/using-bitbanana/emergency-password-pin.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.