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 iCloud Keychain, 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.
  • ✅ 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 "Logout of networks and reset my code".
6. Your new Recovery Code will appear.
7. Copy and store it safely. On macOS, it's saved to iCloud Keychain by default (check using Keychain Access). 
   1. We recommend using a password manager to store it if planning to store outside of iCloud Keychain or Google Password Manager
8. Paste the new Recovery Code when prompted, then click Confirm Code.
9. Once reset process is done, connect your chat network accounts again.
   

   

📱 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. Tap "Use your Recovery Code" → then tap "Reset Encryption".
4. Wait for the app to generate your new Recovery Code.
5. Choose how to save it:
6. Tap "Copy to Clipboard" → then "Backup Manually"
7. Or choose "Store in iCloud Keychain"
8. Approve Notifications and Contacts access.
9. Go to Stack (☰ icon) → Settings (⚙️ icon) → Network Connections → reconnect your chat accounts.

🤖 Beeper Android

1. Sign out of the app (if already logged in).
2. Reopen Beeper and sign in using your email and 6-digit code.
3. Grant Contacts and Notifications permissions when prompted.
4. When asked to verify, tap "Use Recovery Code" → then tap "Lost your Recovery Code?"
5. Tap "Reset" to confirm.
6. Your new Recovery Code will appear:
7. Optionally store it in Google Password Manager
8. Or tap Advanced → Copy, then save it manually in a secure place.
9. Continue setup and choose your preferred Inbox layout.
10. Tap the gear icon (⚙️) → Network Connections → reconnect your chat networks.

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.