# Initial Setup

Jitterbug requires a few files to work properly. You'll only need to do this once.

## Prerequisites

* Windows, Mac or Linux computer with an Internet connection
* iOS device with an Internet connection
* Lightning cable (for connecting the device to your computer)

{% hint style="info" %}
If you do not have a paid Apple Developer account, the "iOS device" will be your secondary device. Otherwise, do this on your main device.
{% endhint %}

## Installing Jitterbug

Installing Jitterbug is quite a simple process. This guide will use AltStore, but you can use other methods you are comfortable with.

1. On your computer, head over to the [Jitterbug Releases](https://github.com/osy/Jitterbug/releases).
2. Choose the correct file for your situation:\
   **If you have a paid Apple Developer Account, choose "Jitterbug.ipa".**\
   **Otherwise, choose "JitterbugLite.ipa"**
3. Sideload with AltStore. You can find a guide on the Internet, or use my guide [here](https://altstore.io).

## Downloading JitterbugPair

We need to generate a "pairing file" for your iOS device. This will enable Jitterbug to connect to your device wirelessly.

1. Again, head over to the [Jitterbug Releases](https://github.com/osy/Jitterbug/releases).
2. Choose the right download for your operating system.\
   jitterbugpair-win64.zip for Windows\
   jitterbugpair-macos.zip for macOS.\
   jitterbugpair-linux.zip for Linux
3. Extract the ZIP file downloaded
4. Connect your iOS device to your computer
5. Run the extracted executable

{% hint style="warning" %}
If the executable stops with no saved pairing file, you need to "Trust this Computer" on your iOS device.
{% endhint %}

This will generate a pairing file for your device, and put it in the same folder you ran JitterbugPair from.

Transfer this pairing file to your iOS device. You can use AirDrop, or what I normally use, [SnapDrop](https://snapdrop.net/).

## Downloading the Developer Disk Image

When tethering, you need to mount a Developer Disk Image. We'll download and import this on your iOS device.

1. Head over to [this GitHub repository](https://github.com/haikieu/xcode-developer-disk-image-all-platforms/tree/master/DiskImages/iPhoneOS.platform/DeviceSupport). It contains all the developer disk images, taken straight from Apple.
2. Download the correct archive for your device.

{% hint style="warning" %}
Not all iOS versions have a disk image. If your version is not listed, choose the version before it.
{% endhint %}

Extract the archive, and save it somewhere you can find it later.

## Importing files to Jitterbug

Now we'll take the collected files, and send them to Jitterbug.

Open Jitterbug, and proceed to follow the next steps:

#### Pairing File

1. Tap "Pairings"
2. Tap the import icon in the top right
3. Choose the pairing file you transferred from your computer

#### Developer Disk Image

1. Tap "Support Files"
2. Tap the import icon in the top right
3. Find these files from the archive, and import them:\
   **DeveloperDiskImage.dmg**\
   **DeveloperDiskImage.dmg.signature**

## Done!

That's the initial setup for Jitterbug! Now, proceed to tethering UTM:

{% content-ref url="/pages/Zucvcf2lEbvHakkQ8O91" %}
[Launching UTM](/utm/tethering-utm/jitterbug/launching-utm.md)
{% endcontent-ref %}


---

# 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://guides.bludood.com/utm/tethering-utm/jitterbug/initial-setup.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.