Why This Matters

Your Recovery Code is like the key to your encrypted chat history on Beeper. Without it, you can’t unlock or access your old messages. It’s part of how Beeper keeps your data safe — only you can read your messages.

If you’ve lost your Recovery Code, you’ll need to create a new one. If you reset it, please note that you won’t be able to access your old encrypted messages that are tied to that previous code anymore. They stay locked and tied to your old recovery code. Resetting will allow you to start fresh. 

Given the this, we recommend checking if your Recovery Code is stored somewhere safe before starting the reset process. Here's where it may have been stored:

• On Android: Check Google Password Manager, any password manager apps, or your personal notes.
• On iOS: Check Passwords (iPhone or iPad), Keychain Access (Mac), or any notes or password manager apps.

If you still can't find it, you can reset it using the steps outlined below.

What You Need to Know:

Resetting your Recovery Code will:

• Log you out of all chat networks in Beeper.
• Require you to reconnect each chat network account.
• Message history may be lost depending on the service. Beeper's chat history backfill capabilities are outlined here.
  • ✅ Recoverable history (after reconnecting): Matrix (Beeper), Facebook (except E2E chats), WhatsApp, Telegram, Google Messages, Signal (if message history transfer is enabled)
  • ❌ Not recoverable: Instagram, Google Chat, LinkedIn, Discord

Your Recovery Code is tied to your Beeper account, not a specific device. As such, you only need to reset it in one Beeper app (Desktop, Android, or iOS), not in each of them. 

✅ How to reset your recovery code:

💻 Beeper Desktop

1. Install the latest version of the Beeper Desktop app (Mac/Windows): beeper.com/download 
2. Open the app and enter your Beeper-linked email address.
3. Enter the 6-digit verification code sent to your email.
4. When asked to verify:
   1. If you have your old Recovery Code, enter it.
   2. If not, click "Lost your Recovery Code?"
5. Click "Reset Recovery Key". This removes all of your connected chat networks and provides you with a new recovery code.
6. Connect one chat network account and you should be taken to the inbox afterwards.
7. To view your new recovery code, go to Settings > click on your profile > click on the dropdown arrow on the top right and select ‘Show Recovery Key’
8. Copy and store it safely. On macOS, it's saved to iCloud Keychain by default (check using Keychain Access). We recommend using a password manager to store it if planning to store outside of iCloud Keychain or Google Password Manager

📱 Beeper iOS

1. Open the Beeper iOS app and log in with your email.
2. Enter the 6-digit code sent to your email.
3. Once you're taken to the ‘Enter Recovery Code’ screen, select “Lost your Recovery Key?”
4. You will be asked to confirm ‘Reset encryption keys?’. Tap ‘Confirm’.
5. The app will then set up your encryption again and take you straight to Settings > Accounts, where you can connect your chat accounts again 
6. To view your new recovery code, you can go to Settings > click on your profile > Show Recovery Code. You can save this code manually or save it to your Passwords app (recommended!) for easy storage.

🤖 Beeper Android

1. Open Beeper and sign in using your email and enter the 6-digit code you receive via email
2. When asked to verify, tap "Use Recovery Code" → then tap "Lost your Recovery Code?"
3. Tap "Reset" to confirm.
4. You will then be taken straight to Connect Chat Accounts where you can reconnect your chat networks.
5. As soon as you connect one chat network account, you'll be able to access the rest of the app.
6. To view your Recovery Code, you can go to Settings > Profile > tap on the three dot icon on the top right > Show Recovery Key

FAQs:

1. Can I retrieve my recovery code from another Beeper app I'm still logged in to? 
   • If you don't have your Beeper Recovery Code on hand (stored), but you have another Beeper app already verified, DO NOT rely on that device. Since sooner or later, you will need a Beeper Recovery Code, go ahead and reset it. (You will need to sign out and re-verify your account on the other app.)
      
2. I'm seeing “Encrypted Message” in my chats. How can I fix this?
   • After resetting, make sure to log out of all Beeper devices and log back in, then verify your login using the new recovery code.
     
     When you reset your Recovery Code in one Beeper app, it creates a new encryption key for your account. If you’re still logged into Beeper on other devices using the old code, those apps will keep using that outdated key. That outdated key will not work when decrypting messages sent and received in your chat network accounts, since your chat networks are now linked to the new code. Instead, they will show up as "encrypted message" on those devices until you sign out and log back in with the updated Recovery Code.
      
3. I'm seeing an error when entering my new code
   • We recommend double checking the code you're entering (especially if entering manually) as it is case-sensitive. If you're sure that you have the right code, you can Contact Support or submit a bug report by pressing on the bug icon on the top right of your app (iOS, Android) or selecting the dropdown arrow on the top right > Report a Problem on Beeper desktop.