How to install an ipa/app file into iPhone with command line?

Asked 26/1, 2013 at 9:0 Answered 5/11, 2015 at 14:33

I want to know how to install an ipa/app file into iPhone just using the command line?

The device maybe without jailbreak or jailbroken already.

I tried to use the command line: xcodebuild, but failed. I didn't find the parameter how to set the destination, maybe a real device, not a simulator.

What options do I have?

Oftentimes answered 26/1, 2013 at 9:0 Comment(5)

I don't think it's possible. But what's wrong with installing app through Xcode or TestFlight? – Devonian 26/1, 2013 at 9:2

oh, I want to run unit test on a real device by Instruments. so I have to write a script to intall an ipa/app file in to iphone auto-intall. – Oftentimes 26/1, 2013 at 9:8

You can't, the best you can do is use wireless installation from the iDevice. – Mancuso 26/1, 2013 at 9:21

Yes, I search the answer. and it shows use openSSH and wifi, but I think it's unsteady to deploy unit test. – Oftentimes 26/1, 2013 at 9:42

ios-deploy --debug --bundle your_iPA_Path.app. using this command you can install ipa on device but make sure you have installed provisioning profile and certificate. – Vertebrate 15/9, 2017 at 5:26

Three ways I know of:

These guys wrote a tool in Ruby to do it. It uses the Fruitstrap library which in turn uses one of Apple's private APIs, so this could possibly break in the future.
You can also just use Fruitstrap on its own, but then you need an .app directory, whereas the Transporter Chief tool I linked above supports both .app and .ipa deployments (as required in your answer).

In either case, you need to have XCode installed for it to work, but the device does not need to be jailbroken.

Thirdly, there is also a binary distribution for OS X of the libimobiledevice library, which enables Linux boxes to talk to iOS devices. This has a few different tools, one of which can install valid signed IPAs to the device using this syntax:
```
ideviceinstaller -i myapp.ipa
```
The advantage of this method is that it does not need XCode or even iTunes.

Cavite answered 1/2, 2013 at 17:59 Comment(1)

Does this (libimobiledevice) work on latest ios devices like ios 9? I am being thrown error "Could not start com.apple.mobile.installation_proxy!". – Airlike 31/8, 2016 at 11:55

With the new Apple Configurator 2 application, you can Install Automation Tools... from the menu. This will add support for the command-line tool "cfgutil".

cfgutil allows you to install ipa's from the command-line using cfgutil install-app <AbsolutePathToIpa>. We use it on our build server to automatically update the device with the latest build.

Peres answered 5/11, 2015 at 14:33 Comment(4)

This is should be the answer :) Thanks! – Staid 20/9, 2016 at 6:33

This tool does not work well. There's no way to simply 'update' the app. You have to remove it first, and (so far) during my testing it just immediately deletes the app anyway after a "successful" install (while other ways of installing it like XCode/TestFlight work fine for me). – Kalpak 19/10, 2016 at 3:4

I can't believe Apple doesn't allow you to upgrade an app with this tool. Otherwise, this would be the best solution. – Haldes 8/12, 2016 at 14:48

Just tested this. (Building with xcode 10.2, Running on iOS 13.3) It updates app now beautifully, BUT the actual app has to be backgrounded. While app is in foreground, it won't update. When you press home button, then you can see the icon being updated. Pretty neat! – Paddie 7/2, 2020 at 11:17

I've just gathered in a single post (Gist) how to achieve this, using

1.- Mattt's library Shenzhen

2.- Phonegap's library ios-deploy

Read here:

How to generate and install an IPA file

Sansculotte answered 13/1, 2015 at 11:51 Comment(0)

I've tried libimobiledevice-macosx. works fine on iPhone 5. iOS version 6.1.4. I was able to install app and see log output like in xcode :) Thank you!

Hairston answered 14/8, 2013 at 6:21 Comment(0)

Recommended topics

Hot tags