Skip to main content

Support

note

OpenBubbles is not responsible for your Apple Account or any Apple devices. OpenBubbles works best with Mac Hardware codes, and using only an Apple Account at one time or a phone number may fix issues.

Suggestions & Reporting Issues

If you wish to report bugs, issues or suggestions with the OpenBubbles app itself please visit:

https://github.com/OpenBubbles/openbubbles-app/issues

Support & Community

Talk to us at https://discord.gg/98fWS4AQqN in the OpenBubbles support and general channels.

Common Issues

Fixing Contacts

When you first install OpenBubbles, your contacts may not be properly displayed. In order to fix this, restart your phone.

Why can't I see my messages sent with OpenBubbles on other Apple devices, even though my Apple Account is linked?

  • This is a known issue and should fix itself after 24 hours.

Why can't I send & receive messages?

  • Running clear identiy cache (Go to settings, troubleshooting) - This may help with sending messages.
  • Make sure iMessage/Facetime is disabled on your iPhone (Only if you are using Relay Apps)
  • You are deregistered - Check your registration status and renewal time in your profile settings and check your registration method and try again.
  • Advanced Data Protection is enabled - Disable this option
  • Contact Key Verification is enabled - Disable this option
  • Your Apple Account/Hardware has been throttled/banned/blocked by Apple - Visit this site to learn more. You may need to create a new account.

Contact us in the discord if issues persist.

Debug relay issues

  • Make sure your device is powered on.
  • Make sure your device is connected to Wi-fi
  • Change Auto-Lock to never on your device (This may lead to screen burn in, lowering brightness will help mitigate this)
  • Ignore if on version V1.8 or higher. Set location services to always for the relay app. (Go to Settings, Privacy & Security, Location Services and Relay)
  • Enable Keep Awake in relay app
  • If using a VPN check if Apple domains and services are blocked.
  • Make sure relay app and OpenBubbles are updated

Mac iMessage issues

  • If you have issues with activating iMessage. You can visit this site and try to fix the issue.

  • If the above site does not work - you may need to contact Apple support.