# Install ios-deploy with Homebrew, MacPorts, Nix Install and debug iPhone apps from the command-line. Version 1.12.2 via Homebrew; verified from local package data. ## Install ```sh sudo av install brew:ios-deploy ``` Additional install commands: ### macOS - Homebrew (100%): ```sh brew install ios-deploy ``` Evidence: local Homebrew formula metadata - MacPorts (94%): ```sh sudo port install ios-deploy ``` Evidence: MacPorts ports tree: devel/ios-deploy/Portfile from https://api.github.com/repos/macports/macports-ports/git/trees/master?recursive=1 ### Linux - Nix (92%): ```sh nix profile install nixpkgs#ios-deploy ``` Evidence: nixpkgs package indexes: pkgs/by-name/io/ios-deploy/package.nix from https://api.github.com/repos/NixOS/nixpkgs/git/trees/master?recursive=1 ## Package facts - **Package key:** brew:ios-deploy - **Package manager:** Homebrew - **Package manager page:** - **Version:** 1.12.2 - **Source summary:** Install and debug iPhone apps from the command-line - **Homepage:** - **Repository:** - **Upstream docs:** - **License:** GPL-3.0-or-later AND BSD-3-Clause - **Source archive:** - **Generated:** 2026-07-08T07:18:31+00:00 ## Executables - ios-deploy (cli) - ios-deploy (alias) ## Install behavior - Post-install hook: not defined - Bottle: available on arm64_big_sur, arm64_monterey, arm64_sequoia, arm64_sonoma, arm64_tahoe, arm64_ventura, big_sur, monterey, sonoma, ventura ## Freshness - Page generated: 2026-07-08 - Package-manager version: 1.12.2 - Local data: ok - Upstream repository: https://github.com/ios-control/ios-deploy - Upstream latest detected: 1.12.2 (current) - info: No package-manager update timestamp was available. ## Project history and usage ios-deploy is a command-line tool for installing, launching, debugging, and inspecting iOS apps on physical devices. The upstream README positions it as a way to install and debug apps from the command line, especially for un-jailbroken devices before the iOS 17 tooling shift. ### Project history The repository dates to 2013 and the package.json names Greg Hughes as author. The project historically gave non-Xcode workflows a scriptable bridge to Apple device deployment and LLDB debugging, with a binary exposed as ios-deploy for npm and package-manager installs. The README records an important later transition: Apple changed the system frameworks used for device communication in iOS 17 and supplied command-line tools that can largely replace ios-deploy. It also notes that the old 1.x branch was archived and that planned 2.x restructuring was abandoned in favor of simpler master-branch development. ### Adoption history ios-deploy became part of the Cordova/PhoneGap-style and CI-friendly iOS developer-tool chain because it made device install/debug operations addressable from scripts. npm registry metadata shows npm distribution beginning in 2013, and Homebrew, MacPorts, and Nix packaging in the input metadata show broader package-manager adoption. ### How it is used Typical invocations install an app bundle, launch it under LLDB, list connected devices, upload and download files from an app container, inspect installed bundle IDs, manage provisioning profiles, and emit JSON output for scripts. The README requires macOS, Xcode, and a valid iOS development certificate. ### Why package nerds care ios-deploy is a package-nerd landmark because it turned a GUI-centered Apple workflow into a composable CLI. It became the sort of package CI scripts and hybrid-app toolchains could depend on, while also exposing how sensitive these packages are to private or shifting Apple device-communication frameworks. ### Timeline - 2013: GitHub repository created and npm package publication began. - 2013: Version 1.0 tag appears in the Git history. - 2023: Version 1.12.2 tag used by Homebrew as the stable source archive. - 2023: iOS 17 changed the underlying Apple frameworks, and the README points users toward Apple command-line replacements for many workflows. ### Related projects - The README links SDMMobileDevice as a source for error-code handling and points to PhoneGap milestones, reflecting the tool's relationship to hybrid mobile development. It overlaps functionally with Xcode, LLDB, Apple device tools, and higher-level build systems that need command-line deployment. ### Sources - - - - - ## Security Notes narrow executable package without higher-risk signals. - **Geiger risk:** green / low - narrow executable package without higher-risk signals ## Source Database Details - **Source Database:** Homebrew formula API - **Tap:** homebrew/core - **Full Name:** ios-deploy - **Version Scheme:** 0 - **Revision:** 0 - **Head Version:** HEAD - **Requirements:** macos, xcode - **Bottle Stable Root URL:** - **Deprecated:** no - **Disabled:** no - **Keg Only:** no - **URL Keys:** head, stable ## Other Package-Manager Records - Nix - ios-deploy: normalized package name match | nixpkgs package indexes: pkgs/by-name/io/ios-deploy/package.nix from https://api.github.com/repos/NixOS/nixpkgs/git/trees/master?recursive=1 - MacPorts - ios-deploy: normalized package name match | MacPorts ports tree: devel/ios-deploy/Portfile from https://api.github.com/repos/macports/macports-ports/git/trees/master?recursive=1 ## Related links - [Source-control packages](https://www.automicvault.com/pkg/source-control-tools/) - Belongs to a source-control command family. - [Terminal utility packages](https://www.automicvault.com/pkg/terminal-utilities/) - Matched terminal and command-line workflow metadata. - [Text processing packages](https://www.automicvault.com/pkg/text-processing-tools/) - Matched text, document, or structured-data processing metadata. - [Developer build packages](https://www.automicvault.com/pkg/developer-build-tools/) - Matched build, compiler, generator, or developer workflow metadata. - [ios-sim](https://www.automicvault.com/pkg/brew/ios-sim/) - Shares av.db curated category or tags: cli, developer-tools, ios, mobile-development. - [ipapatch](https://www.automicvault.com/pkg/brew/ipapatch/) - Shares av.db curated category or tags: cli, developer-tools, ios, mobile-development. - [ipatool](https://www.automicvault.com/pkg/brew/ipatool/) - Shares av.db curated category or tags: cli, developer-tools, ios, mobile-development. - [react-native-cli](https://www.automicvault.com/pkg/brew/react-native-cli/) - Shares av.db curated category or tags: cli, developer-tools, ios, mobile-development. - [rswift](https://www.automicvault.com/pkg/brew/rswift/) - Shares av.db curated category or tags: cli, developer-tools, ios, mobile-development. - [ideviceinstaller](https://www.automicvault.com/pkg/brew/ideviceinstaller/) - Shares av.db curated category or tags: cli, developer-tools, ios, iphone, mobile-development. - [kdoctor](https://www.automicvault.com/pkg/brew/kdoctor/) - Shares av.db curated category or tags: cli, developer-tools, mobile-development. - [libimobiledevice](https://www.automicvault.com/pkg/brew/libimobiledevice/) - Shares av.db curated category or tags: cli, developer-tools, ios, iphone. - [ios-deploy](https://www.automicvault.com/pkg/npm/ios-deploy/) - Same normalized package name appears in another local ecosystem. Shared terms: apps, deploy, ios, ios-deploy, line. - [ios-webkit-debug-proxy](https://www.automicvault.com/pkg/brew/ios-webkit-debug-proxy/) - Package names and metadata indicate a similar tool family. Shared terms: cli, debug, debugging, developer, developer-tools. - [ios-deploy](https://www.automicvault.com/pkg/npm/ios-deploy/) - Same normalized package name in another local ecosystem. ## Combined YAML source View the package source record on GitHub. [combined/ios-deploy.yml](https://github.com/automic-vault/db/blob/main/combined/ios-deploy.yml) ## Sources - Nucleus package database - Geiger risk classifier - package-page enrichment - curated package history - package version freshness - av.db category and tag curation - package relationship graph - external package-manager database matches - cross-ecosystem install command graph