CocoaPods: pod install failed / not installed Flutter / Dart Origin: On your device Last updated 4 Nov 2026

Flutter iOS: Error running pod install — CocoaPods not installed or out of date / [!] CocoaPods could not find compatible versions for pod

The iOS build cannot install its native dependencies because CocoaPods is missing, outdated or a pod's version constraints conflict.

Exact message you may see Error running pod installCocoaPods not installed or not in valid stateCocoaPods could not find compatible versions for pod[!] CocoaPods's specs repository is too out-of-date to satisfy dependenciesWarning: CocoaPods not installed. Skipping pod install
Explore the map of this error Full error map →
Seen on: Flutter iOS

Meaning

Install CocoaPods (sudo gem install cocoapods or brew install cocoapods), then in ios/ run pod repo update and pod install. Conflicts mean a plugin requires a newer iOS target or incompatible Firebase SDKs; run pod install --repo-update and align versions.

Common causes

  • CocoaPods not installed or old
  • Podfile.lock out of sync with plugins
  • Outdated spec repo
  • iOS deployment target too low
  • Ruby/arch problems on Apple Silicon

⚡ Quick fix

  1. brew install cocoapods then cd ios && pod repo update && pod install
  2. Delete Podfile.lock and Pods/ and reinstall
  3. Raise platform :ios, '13.0' in Podfile

Detailed fix by platform

Flutter

  1. cd ios && rm -rf Pods Podfile.lock && pod install --repo-update

How to diagnose

  1. Pods — Installed version?
  2. Lock — Stale?
  3. Target — iOS platform line?

🔧 Still not fixed?

Many errors look alike. If the steps above didn’t solve it, one of these is probably what you’re facing:

Where this error sits

Origin: On your device. Errors that are often confused with or caused by this one (click to open):

Android license status unknown / licenses not accepted — flutter doctor: Android license status unknown. Run `flutter doctor --android-licenses` to accept the SDK licenses (Flutter / Dart)Android license statu…App Transport Security has blocked a cleartext HTTP load — iOS: The resource could not be loaded because the App Transport Security policy requires the use of a secure connection (NSURLErrorDomain -1022) (Flutter / Dart)App Transport Securit…BoxConstraints forces an infinite width — Flutter: BoxConstraints forces an infinite width. These invalid constraints were provided to RenderStack's layout() function (TextField in a Row) (Flutter / Dart)BoxConstraints forces…CDN: trunk URL couldn't be downloaded — [!] CDN: trunk URL couldn't be downloaded: https://cdn.cocoapods.org/... (iOS)CDN: trunk URL couldn…CocoaPods compatible versions — CocoaPods could not find compatible versions for pod (iOS)CocoaPods compatible …Dependency requires compileSdk 34 or later — Android Gradle: Execution failed for task ':app:checkDebugAarMetadata'. Dependency requires libraries and applications that depend on it to compile against version 34 or later of the Android APIs (Flutter / Dart)Dependency requires c…library not found for -lPods — ld: library not found for -lPods-AppName / framework not found Pods_App (iOS)library not found for…Module 'x' not found (iOS build) — Xcode: Module 'firebase_core' not found — flutter build ios fails after adding a plugin (Flutter / Dart)Module 'x' not found …CocoaPods…

Explore the map of this error Full error map →

🧠 Still stuck? Analyze your error

Paste the full message, response headers or stack trace — we'll detect the platform and point to the most likely cause.

💬 What worked for others

No tips yet — did something else fix this for you?

Share what worked for you

Tips are checked by an editor before they appear. Links are removed.