---
schema_version: "1"
id: 386fb10ead155e53b3b9220e20e9af4eddff79b19fad6f23af3c637221d9504f
title: Add the Service SDK Frameworks with CocoaPods
collection: legacydeveloper
version: current
locale: en-us
portal_url: https://docs.salesforce.com/legacydeveloper/current/en-us/service_sdk_ios/ios_install_sdk_cocoapods.md
canonical_url: https://developer.salesforce.com/docs/atlas.en-us.service_sdk_ios.meta/service_sdk_ios/ios_install_sdk_cocoapods.htm
source_site: developer.salesforce.com
content_type: documentation
content_hash: 8281e8cc4d18735941ab5b2aa57a5dfab3794df1550ac4fd92e09f584c2dc22b
description: Add the SDK frameworks using CocoaPods, a developer tool that automatically manages dependencies.
---
# Add the Service SDK Frameworks with CocoaPods

Add the SDK frameworks using CocoaPods, a developer tool that automatically manages dependencies.

![Important](https://developer.salesforce.com/docs/atlas.en-us.service_sdk_ios.meta/service_sdk_ios/images/icon_note_important.png)

#### Important

The legacy chat product is scheduled for retirement on February 14, 2026, and is in maintenance mode until then. During this phase, you can continue to use chat, but we no longer recommend that you implement new chat channels. To avoid service interruptions to your customers, migrate to [Messaging for In-App and Web](https://help.salesforce.com/s/articleView?id=service.miaw_intro_landing.htm&type=5&language=en_US) before that date. Messaging offers many of the [chat features that you](https://help.salesforce.com/s/articleView?id=service.miaw_chat_vs_messaging.htm&type=5&language=en_US) love plus asynchronous conversations that can be picked back up at any time. Learn about chat retirement in [Help](https://help.salesforce.com/s/articleView?id=001790618&type=1&language=en_US).

1. If you haven't already done so, install the [CocoaPods](https://cocoapods.org/) gem and initialize the CocoaPods main repository.
    
    sudo gem install cocoapods
    pod setup
    
    ![Note](https://developer.salesforce.com/docs/atlas.en-us.service_sdk_ios.meta/service_sdk_ios/images/icon_note.png)
    
    #### Note
    
    The minimum supported version of CocoaPods is 1.0.1. If you're not sure what version you have, use pod --version to check the version number.
2. If you already have [CocoaPods](https://cocoapods.org/) installed, update your pods to the latest version.
    
    pod update
3. Change to the root directory of your application project.
4. Create or edit a file named Podfile that contains the Service Chat SDK dependency.
    1. If you want to install the complete Service Chat SDK, update your Podfile to include ServiceSDK.
        
        source 'https://github.com/CocoaPods/Specs.git'
        source 'https://github.com/goinstant/pods-specs-public'
        
        # To use the SDK (with all components)
        target '<your app target>' do
            pod 'ServiceSDK'
        end
    2. If you want to install a single Service Chat SDK component, create a similar Podfile to the one specified above, but only include the desired pod.
        
        | Feature | Pod name |
        | --- | --- |
        | Chat | ServiceSDK/Chat |
        
        For example, the following Podfile installs Chat.
        
        source 'https://github.com/CocoaPods/Specs.git'
        source 'https://github.com/goinstant/pods-specs-public'
        
        # To use Chat
        target '<your app target>' do
            pod 'ServiceSDK/Chat'
        end
        
        If you don't specify a version number, you automatically get the latest version of that component. If you want to add a specific version to your component, be sure to add the version number of the Service Chat SDK and _not_ the version number of the individual component.
5. Run the CocoaPods installer.
    
    pod install
    
    This command generates a .xcworkspace file for you with all the dependencies included.
    
    ![Note](https://developer.salesforce.com/docs/atlas.en-us.service_sdk_ios.meta/service_sdk_ios/images/icon_note.png)
    
    #### Note
    
    If you run into issues installing or updating the SDK, clear the local CocoaPods cache and then perform a pod update.
6. Open the .xcworkspace file that CocoaPods generated and continue with the installation process.
    
    ![Note](https://developer.salesforce.com/docs/atlas.en-us.service_sdk_ios.meta/service_sdk_ios/images/icon_note.png)
    
    #### Note
    
    Be sure to open the .xcworkspace file (which includes all the dependencies) and _not_ the .xcodeproj file.

Once you've added the SDK frameworks, proceed with [the installation instructions](https://developer.salesforce.com/docs/atlas.en-us.service_sdk_ios.meta/service_sdk_ios/ios_sdk_install_overview.htm "Before you can use the iOS SDK, install the SDK and configure your project.").