URL: https://docs.dixa.io/docs/dixamessenger/ios/installation

# Installation

Add the Dixa Messenger SDK to your iOS app.

## Requirements

| Requirement | Details |
| --- | --- |
| iOS | 16 |
| Xcode | 26.2 |
| Swift language mode | Swift 5 or Swift 6 |
| Messenger token | An admin can find it in the Dixa Dashboard under `Settings > Messenger > (your messenger) > Setup` |

## Installation

Install the SDK with Swift Package Manager (recommended), CocoaPods, or by adding the XCFramework by hand.

### Swift Package Manager (recommended)

1. In Xcode, select **File > Add Package Dependencies…** and enter this URL:

   ```text
   https://github.com/dixahq/ios-messenger
   ```

2. Keep the dependency rule **Up to Next Major Version**, so you get every fix in the current major version.

In a `Package.swift` manifest, replace `<VERSION>` with the latest version from the [releases page](https://github.com/dixahq/ios-messenger/releases):

```swift
.package(url: "https://github.com/dixahq/ios-messenger", from: "<VERSION>")
```

### CocoaPods

In your `Podfile`, add:

```ruby
pod 'DixaMessengerKit', '~> 2.2'
```

### Manual

1. Download the XCFramework from the [releases page](https://github.com/dixahq/ios-messenger/releases) and unzip it.
2. Place it on the Framework search path of your Xcode project and add it to your app target.
3. Set it to **Embed & Sign**.

Next, [configure the SDK](https://docs.dixa.io/docs/dixamessenger/ios/usage.md#configuring-dixamessenger).