# Registering a Phone Number with your iMessage Account

{% hint style="warning" %}
The following links are to external websites that are not affiliated with BlueBubbles and their content can change at any time. Use at your own risk.
{% endhint %}

## SIM / eSIM Swapping Methods

The following guide is maintained by a BlueBubbles community member and is a really good resource to find out information about registering your phone number using SIM-swapping

{% embed url="<https://guide.atbluebubbles.com/>" %}

## Non-Jailbreak Methods

The following guides *do not* require you to have a jailbroken iPhone to accomplish phone number registration

{% embed url="<https://www.reddit.com/r/BlueBubbles/comments/1938ock/stop_using_old_methods_heres_a_new_one/>" %}
A newer SIM-card-swap method that is easier than previous methods and with additional instructions for eSIM-only iPhone models.
{% endembed %}

{% embed url="<https://www.reddit.com/r/AirMessage/comments/avj2y5/how_to_use_phone_number_with_airmessage_sometimes/>" %}
Despite the title, this works with BlueBubbles as well A variety of methods using a spare iPhone. May be more compatible with older models of iPhone. Some of the methods require keeping an inactive SIM card in an iPhone while others involve removing the SIM card from the iPhone and leaving it turned off.
{% endembed %}

## Jailbreak Methods

The following guides *require* you to have a jailbroken iPhone to accomplish phone number registration

{% embed url="<https://www.github.com/AwesomeIndustry/SIMLessPNRGateway>" %}
A jailbreak method for a spare iPhone on iOS 12\
A writeup with easier-to-follow instructions: [SIMLess PNR Gateway Tutorial (Beginner Version)](https://docs.google.com/document/d/1L4HijxDCHkBBJ66RysCBKvNEK7yihM-rgJ-U4W56vJ0/)
{% endembed %}

{% embed url="<https://www.github.com/AwesomeIndustry/VintagePNR>" %}
A jailbreak method for a spare iPhone on iOS 10
{% endembed %}

{% embed url="<https://www.github.com/thatmarcel/beepserv-rewrite>" %}
A jailbreak method for a spare iPhone, rewritten from the now-defunct [beepserv](https://github.com/beeper/phone-registration-provider)
{% endembed %}


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://docs.bluebubbles.app/server/advanced/registering-a-phone-number-with-your-imessage-account.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
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.