/

Install via Homebrew

Install Shield iOS using the ByteHide Homebrew tap. The easiest option on macOS — no Python environment management needed.

Install

Bash
brew tap bytehide/tap
brew install shield-ios

Or in one command:

Bash
brew install bytehide/tap/shield-ios

Verify the installation:

Bash
shield-ios version

Update

Bash
brew upgrade shield-ios

Uninstall

Bash
brew uninstall shield-ios
brew untap bytehide/tap

Usage

Once installed, the shield-ios CLI works the same as with pip:

Bash
# Initialize config
shield-ios init

# Protect an IPA
shield-ios protect MyApp.ipa --config shield-ios.json

# Protect an xcarchive
shield-ios protect MyApp.xcarchive --config shield-ios.json --no-sign

See CLI Reference for full usage details, available protections, and configuration examples.

Using with Xcode

Homebrew installs to /opt/homebrew/bin (Apple Silicon) or /usr/local/bin (Intel). Make sure to include this path in your Xcode post-archive action:

Bash
export PATH="/opt/homebrew/bin:/usr/local/bin:$PATH"
shield-ios protect "$ARCHIVE_PATH" -o "$ARCHIVE_PATH" --config "${PROJECT_DIR}/shield-ios.json" --no-sign

See Xcode Integration for the full setup guide.

Troubleshooting

"shield-ios: command not found" after install

Start a new terminal session, or run:

Bash
eval "$(brew shellenv)"

Formula conflicts

If you also have Shield iOS installed via pip, the Homebrew version takes precedence (its bin path is usually first in PATH). To avoid conflicts, uninstall one of them:

Bash
pip uninstall bytehide-shield-ios
# or
brew uninstall shield-ios

Next Steps

CLI Reference

Full CLI reference and protection options

Xcode Integration

Protect automatically on Archive

Fastlane Plugin

CI/CD with Fastlane

Previous
CLI (pip)
Next
Fastlane Plugin