# 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="launching-utm" %}
[launching-utm](https://guides.bludood.com/utm/tethering-utm/jitterbug/launching-utm)
{% endcontent-ref %}