> ## Documentation Index
> Fetch the complete documentation index at: https://help.hoseki.app/llms.txt
> Use this file to discover all available pages before exploring further.

# PIN and lock

> Set, change, and reset your PIN. Lock the app.

Control Center uses a **6-digit PIN** on desktop and StartOS. It stops anyone else on your computer or network from opening it.

## Set your PIN

| Platform | Where |
| - | - |
| Mac and Windows | The app asks on first launch. |
| StartOS | In StartOS: **Actions** → **Set PIN**. |

![Set up your PIN screen with six empty circles](https://mintcdn.com/hoseki-corp/_2lLnSp9Pv5wFk6_/images/security-pin-setup.png?fit=max\&auto=format\&n=_2lLnSp9Pv5wFk6_\&q=85\&s=e7922dd7926d255a61a04f4056a0b946)

Enter 6 digits, then enter them again.

On Mac and Windows:

1. On **Set up your PIN**, enter 6 digits.
2. On **Confirm your PIN**, enter them again. Select **Back** to start over.

   Don't match? You see **Those PINs didn't match. Choose your PIN again.** Start from step 1.
3. On **Your PIN is set**, select **Show PIN** or **Copy PIN** to save it in your password manager.
4. Select **Continue**.

![Your PIN is set screen with Show PIN and Copy PIN](https://mintcdn.com/hoseki-corp/CZpiRtc-3kdaNAyJ/images/security-pin-saved.png?fit=max\&auto=format\&n=CZpiRtc-3kdaNAyJ\&q=85\&s=086e641ec728b2d5bd8e8327b10846ca)

Your PIN is set. Show or copy it before you continue.

On StartOS, the app shows **Set your PIN in StartOS** until you run the action.

## Unlock

Enter your PIN each time you open Control Center.

![Enter your PIN screen with a Forgot PIN? link](https://mintcdn.com/hoseki-corp/_2lLnSp9Pv5wFk6_/images/security-pin-enter.png?fit=max\&auto=format\&n=_2lLnSp9Pv5wFk6_\&q=85\&s=eb96d584aa44f1b01da67e773a04bced)

Enter your PIN.

**Wrong PIN?** You get 5 tries. After that, you wait 30 seconds. Each further wrong try doubles the wait, up to 1 hour.

| You see | Meaning |
| - | - |
| **Wrong PIN. 2 more tries before a short wait.** | You're close to the limit. |
| **Too many wrong PINs. Try again in …** | Wait for the timer, or use **Forgot PIN?**. |

Quitting or restarting doesn't clear the wait. **Forgot PIN?** still works and clears it.

## When the app locks

* You select the **padlock** icon at the top right.
* You close the desktop window.
* You reopen a closed tab, or duplicate a tab.
* The app or server restarts. Everyone is signed out.

Reloading the page or minimizing the window does not lock it. There is no idle timeout.

## Change your PIN

Open **Settings** → **Security** → **Change PIN**.

1. **Enter your current PIN.**
2. **Choose a new PIN.**
3. **Confirm your new PIN.**

Select **Back** to go back a step. Other tabs and browsers are signed out.

On StartOS, **Sign out everywhere** signs out every browser at once.

## Forgot your PIN?

Select **Forgot PIN?** on the sign-in screen. Your accounts and history are kept on every platform.

![Reset your PIN screen showing PIN reset. Restarting Control Center…](https://mintcdn.com/hoseki-corp/Xp9pk49cGAID_gA6/images/security-pin-reset.png?fit=max\&auto=format\&n=Xp9pk49cGAID_gA6\&q=85\&s=c9e70747952cf441bb4315bf97df0f33)

Reset your PIN. Your accounts stay put.

> [tab] Mac and Windows
>
> 1. Select **Reset PIN**.
> 2. Confirm you're an administrator.
>    * **Mac:** the prompt says **Bitcoin Control Center wants to reset its PIN.** Enter an administrator's name and password.
>    * **Windows:** a User Account Control prompt for **Windows Command Processor** appears. This is expected. Select **Yes**, or enter an administrator's password.
> 3. You see **PIN reset. Restarting Control Center…**
> 4. On **Choose a new PIN**, set a new PIN.
>
> Cancelled the prompt? You see **PIN not reset. Nothing changed.**
>
> Not an administrator on this computer? Ask one to approve the prompt.
>
> Quit before you set a new PIN? Next time you see **Set up your PIN**. Your accounts and history are still there.

> [tab] StartOS
>
> 1. Open StartOS. Go to Bitcoin Control Center.
> 2. Select **Actions** → **Set PIN**. Enter a new PIN.
> 3. Come back. Enter the new PIN.

Umbrel support is coming soon. Questions? Email [support@hoseki.app](mailto:support@hoseki.app).


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.