> For the complete documentation index, see [llms.txt](https://atbluebubbles.gitbook.io/guide/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://atbluebubbles.gitbook.io/guide/new-methods/beepserv-jailbroken.md). # Beepserv (Jailbroken) {% hint style="danger" %} Beepserv is no longer recommended as it tended to only work once and otherwise be unreliable. Please use relayserver or ValidationRelay even if using Beeper Mini.\ \ This article remains for historic purposes. {% endhint %} *** {% hint style="warning" %} While using the Beepserv tweak on a jailbroken iPhone, it is recommended that you use a spare Apple ID. * Apple has been cracking down on *\[their own]* users for using Beeper/Beeper Mini. It even caused Beeper to remove iMessage **completely** from their platform. {% endhint %} {% hint style="danger" %} Using Beeper is still a tricky situation, please continue with caution. * Use a spare/throw-away Apple ID as it could get you, or your device, banned from using iMessage on any device. *This guide is also very **experimental** and hasn't been tested, but it's a great theory that **may or may** not work. So please continue with caution.* {% endhint %} *** {% hint style="warning" %} **Requirements for Beepserv:** * iPhone 6S and above ***(Needs to be jailbroken)*** * Android Device * Beepserv-rewrite Tweak * [Download the tweak here](https://github.com/thatmarcel/beepserv-rewrite) * Beeper Mini ***(for iMessage)*** * [Download the APK here (Beeper)](https://mini.beeper.com/Beeper_Mini_v1.2.58.apk) * ***This file download link may go down at anytime since the Beeper Mini page has been deleted from their website*** * [Download the APK here (Web Archive)](https://web.archive.org/web/20240329133435/https://mini.beeper.com/Beeper_Mini_v1.2.58.apk) * [Download the APK here (Media Fire)](https://www.mediafire.com/file/u1r73jp6z9vjshx/Beeper_Mini_v1.2.58.apk/file) * A spare/throw-away Apple ID * [Make a new Apple ID here](https://appleid.apple.com/account) {% endhint %} ## Getting jailbroken: Getting jailbroken is needed for this method. For full guides on specific iPhones and iOS jailbreaks, please check [CFW - iOS Guide](https://ios.cfw.guide) and continue with this guide. ## Register your number with Beepserv:
Installing the tweak and registering your number 1. Jailbreak your iPhone and download the Beepserv-rewrite tweak * Depending on your jailbreak, you'll have to download the correct tweak; rootful or rootless 2. Make sure you have the following tweaks installed after you got jailbroken: * Ellekit **(You will need to install this manually. This is needed to make Beepserv work)** * Libhooker * Mobilesubstitute or Mobilesubstrate 3. After installing Ellekit, hit "Reboot" on your installer; Sileo or Zebra 4. Once the device is back on the homescreen, go to your Downloads and open the Beepser-Rewrite tweak in Sileo or Zebra and install it. 5. Once you have installed Beepserv-Rewrite, you will want to do a **Userspace Reboot** * This action may be different between jailbreaks. 6. If everything is done correctly, you should see the **Registration Code** in your Messages settings on your iPhone 7. Once you have your **Registration Code**, download the Beeper Mini ***(for iMessage)*** app on your Android device *(The link is posted above with the requirements)* 8. Open Beeper Mini and it should prompt you to enter your **Registration Code** 9. Once you entered your Registration Code, it will proceed to ask you to enter your Apple ID info * Please use your spare/throw-away Apple ID for safety of your Apple account 10. You should be able to use iMessage with Beeper Mini and start texting your friends or family!
Using BlueBubbles/AirMessage with your spare/throw-away Apple ID 1. Add your spare/throw-away Apple ID to your Mac 2. Set up iMessage for this Apple ID and accept the **"new number"** being added to your spare/throw-away Apple ID 3. Test it by sending iMessage texts to your number or to your friends or family 4. If successful, you should be able to use your BlueBubbles/AirMessage server to send iMessage texts on your Android or Web * *Please don't delete Beeper Mini from your Android device, as it could mess up this process. You can disable notifications from Beeper Mini on your Android device.*
*** ## Troubleshooting Options
Beepserv won't show a code or a new code If Beepserv isn't showing a code or a new code, please try to re-jailbreak and do a **Userspace Reboot** again
I can't get my number registered If you are seeing REG-REQ? texts showing on your Android device, but can't get your number registered with Beepserv, you are most likely being blocked by Apple or your carrier is blocking the service from happening. What you can do is wait for a few days and try again, or contact Apple to try to lift the ban or flag off of your Apple account.
I can't send messages on Beeper Mini If you're not able to send messages on Beeper Mini to make sure that everything is going smoothly, you may need to get a new Registration Code and try again.
My jailbreak keeps making my device reboot I get it, this can be very irritating, especially if it's making the code change, making Beeper Mini not work anymore. What you can do is look into [meowbrek2](https://ios.cfw.guide/installing-meowbrek2/) to do an auto-jailbreak, helping this problem in entirely. Meowbrek2 doesn't work for all iPhones or iOSes, so please continue with caution.
Nothing is working still after the troubleshooting options I get that this can be irritating, but don't worry yet. I recommend that you should uninstall Beeper Mini, get a new code and try it again. This can be a lengthy process, so if all fails, please try the [Physical SIM or eSIM methods](https://guide.atbluebubbles.com/new-methods/getting-your-phone-number-registered) listed on the site.
*** ### Credits: [ThePoetWalsh57](https://www.reddit.com/r/beeper/comments/197tn08/comment/kibhihn/?utm_source=share\&utm_medium=web3x\&utm_name=web3xcss\&utm_term=1\&utm_content=share_button) #### Thank you for a detailed guide to get our numbers registered with Beepserv correctly! ☺️ --- # Agent Instructions This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com. ## Querying This Documentation If you need additional information that is not directly available in this page, you can query the documentation by asking a question. Perform an HTTP GET request on the following URL with the `ask` and `goal` query parameters: ``` GET https://atbluebubbles.gitbook.io/guide/new-methods/beepserv-jailbroken.md?ask=&goal= ``` `ask` is the immediate question: it should be specific, self-contained, and written in natural language. `goal` is what the user is ultimately trying to achieve, the reason they need the answer. Sharing it helps GitBook give you a better, more relevant answer. A goal is most helpful when it describes the outcome the user wants rather than restating the question. For example, with `ask=how do I create an API token`, a goal like `automate deployments from our CI pipeline` lets GitBook tailor the answer to that use case. 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.