I installed Cocoapods version 0.28, and now I want to uninstall it from my machine. How can I do that?

8 Answers 8


First, determine which version(s) of Cocoapods you have installed by running this in Terminal:

gem list --local | grep cocoapods

You see output similar to this:

cocoapods (0.27.1, 0.20.2)
cocoapods-core (0.27.1, 0.20.2)
cocoapods-downloader (0.2.0, 0.1.2)

Here, I have two versions of Cocoapods installed.

To completely remove, issue the following commands:

gem uninstall cocoapods
gem uninstall cocoapods-core
gem uninstall cocoapods-downloader

If you have multiple versions installed, like I have, it will prompt you to choice a specific version or all. If you want to uninstall a specific version you can also use the -v switch as follows:

gem uninstall cocoapods -v 0.20.2

Running gem list --local | grep cocoapods again will confirm that Cocoapods has been removed.

You may have residual artefacts in a hidden folder in your home directory. Remove these with:

rm -rf ~/.cocoapods
  • 5
    add sudo before every command if it gives error like "You don't have write permissions for the /usr/bin directory". For e-g sudo gem uninstall cocoapods Dec 11, 2014 at 10:18
  • 4
    You may also want to remove the files cocoapods creates with: rm -rf ~/.cocoapods
    – Adam
    Mar 20, 2015 at 20:22
  • Thanks sir. However mine were in a Ruby folder so Terminal hinted: try this command instead: 'gem uninstall -i /Users/Rob/.rvm/gems/ruby-2.3.1@global cocoapods'
    – Rob
    Oct 16, 2016 at 8:23
  • gem list doesn't list cocoa pods as installed on my Mac, yet there is a large hidden cocoapods directory in my home directory. How to continue from there? where should I look for cocoapods leftovers? I cannot rely on gem here. Oct 7, 2019 at 4:08
  • @MottiShneor From two comments above your's: rm -rf ~/.cocoapods.
    – neilco
    Oct 8, 2019 at 10:29

I used the following bash script to remove all the relevant gems.

for i in $( gem list --local --no-version | grep cocoapods );
    gem uninstall $i; 

Additionally delete ~/.cocoapods to remove the cache of podspecs.

rm -rf ~/.cocoapods/
  • This is the complete answer Feb 13, 2016 at 18:05
  • 15
    this is same and better: gem list --local --no-version | grep cocoapods | xargs gem uninstall
    – Eir Nym
    Apr 24, 2016 at 13:50
  • 2
    I need sudo for do gem uninstall, so I modified the bash like this (one line command): for i in $( gem list --local --no-version | grep cocoapods ); do sudo gem uninstall $i; done
    – Daniele
    Sep 10, 2019 at 15:53
gem list --local --no-versions | grep cocoapods | xargs sudo gem uninstall
sudo rm -rf ~/.cocoapods
  • 3
    This is the only one that worked for me, thanks! Together with sudo rm -fr ~/.cocoapods/repos/master it finally removed everything. Oct 10, 2018 at 13:27

Easy, just run the following command to remove all or just a specific cocoapod gem:

sudo gem uninstall cocoapods

If you have 2 versions of cocoapods installed and you cannot figure out why or how to delete them, I would ask you this ...

At some point in the past, did you run this command?

sudo gem install cocoapods -n /usr/local/bin

If your answer is yes and you are struggling to find an answer .. do like me and run:

sudo gem uninstall cocoapods -n /usr/local/bin

Get it? :) That should fix the "other" version of cocoapods .. now you are only left with the gem one.

Now you should be ok to just run a sudo gem uninstall cocoapods and then again sudo gem install cocoapods for a clean install.

I would also check this answer as it cleans the caches as well :) https://superuser.com/a/686319/1276003.


I was following this answer but for Mac OS X El Capitan 10.11 I was encountering an error as below on executing gem uninstall -n cocoapods command

pranav-MacBook-Pro:~ pranavpranav$ gem uninstall -n cocoapods
ERROR:  While executing gem ... (Gem::CommandLineError)
    Please specify at least one gem name (e.g. gem build GEMNAME)

In order to overcome the issue with permissions you must use the below command

sudo gem uninstall cocoapods -n /usr/local/bin

This is what perfectly work for me.

  1. Uninstall CocoaPods (choose to uninstall all versions):

    sudo gem uninstall cocoapods

  2. Remove old master repo:

    sudo rm -fr ~/.cocoapods/repos/master

  • 1
    This would be less confusing if you included only the information necessary to uninstall. Adding the bits about reinstallation doesn't make sense as part of an answer to this question. Mar 17, 2017 at 22:12
  • thanx, i will do it next time.
    – BatyrCan
    Mar 23, 2017 at 7:53

Remove lib form Podfile, then pod install again.

You must log in to answer this question.

Not the answer you're looking for? Browse other questions tagged .