408

I installed pod some time ago. However, it's stopped working so I'm working through this again.

However, I almost immediately run into a problem here:

pod install
-bash: pod: command not found

Any suggestions why this happened?

36 Answers 36

654

OK, found the problem. I upgraded Ruby some time ago and blasted away a whole load of gems. Solution:

sudo gem install cocoapods

For none-sudo use:

export GEM_HOME=$HOME/.gem
export PATH=$GEM_HOME/bin:$PATH
gem install cocoapods --user-install
5
  • 8
    if "$ sudo gem install cocoapods" does not work for you with error installing cocoapods: activesupport requires Ruby version >= 2.2.2 then see this answer stackoverflow.com/questions/32871329/… Commented Jul 15, 2016 at 8:33
  • 9
    Why sudo is needed here ? isn't it bad practice to install with sudo ?
    – vikramvi
    Commented Sep 1, 2017 at 9:25
  • 6
    Yes, you don't have to use sudo, see below stackoverflow.com/a/47333482/1158376 Commented Nov 16, 2017 at 15:31
  • 2
    Has anyone else tried this and still gotten the same error as before running it? Still looking for a solution
    – user18899735
    Commented Aug 5, 2022 at 14:31
  • Don't try this for M1. Else you need to suffer with un-installing and re-installing stuff with homebrew. Commented Dec 22, 2022 at 6:57
111

This Step Is Proper Working.

Pod Install

[ 1 ] Open terminal and type:

sudo gem install cocoapods

Gem will get installed in Ruby inside the System library. Or try on 10.11 Mac OSX El Capitan, type:

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

If there is an error "activesupport requires Ruby version >= 2.xx", then install the latest active support first by typing in the terminal.

sudo gem install activesupport -v 4.2.6

[ 2 ] After installation, there will be a lot of messages, read them and if no error found, it means cocoa pod installation is done. Next, you need to set up the cocoa pod master repo. Type in terminal:

pod setup

And wait it will download the master repo. The size is very big (370.0MB in Dec 2016). So it can be a while. You can track the download by opening Activity and go to the Network tab and search for git-remote-https. Alternatively, you can try adding verbose to the command like so:

pod setup --verbose

[ 3 ] Once done it will output "Setup Complete", and you can create your XCode project and save it.

[ 4 ] Then in a terminal cd to "your XCode project root directory" (where your .xcodeproj file resides) and type:

pod init

[ 5 ] Then open your project's podfile by typing in terminal:

open -a Xcode Podfile

[ 6 ] Your Podfile will get open in text mode. Initially, there will be some default commands in there. Here is where you add your project's dependencies. For example, in the podfile, type

/****** These are Third party pods names ******/
pod 'OpenSSL-Universal'
pod 'IQKeyboardManager'
pod 'FTPopOverMenu'
pod 'TYMActivityIndicatorView'
pod 'SCSkypeActivityIndicatorView'
pod 'Google/SignIn'
pod 'UPStackMenu'

(this is For example of adding library to your project).

When you are done editing the podfile, save it and close XCode.

[ 7 ] Then install pods into your project by typing in terminal:

pod install

Depending on how many libraries you added to your podfile for your project, the time to complete this varies. Once completed, there will be a message that says

"Pod installation complete! There are X dependencies from the Podfile and X total pods installed."

2
  • sudo gem uinstall cocoapods then sudo gem install -n /usr/local/bin cocoapods did it for me Commented Nov 10, 2022 at 7:17
  • ERROR: Error installing cocoapods: The last version of activesupport (>= 5.0, < 8) to support your Ruby & RubyGems was 6.1.7.3. Try installing it with gem install activesupport -v 6.1.7.3 and then running the current command again activesupport requires Ruby version >= 2.7.0. The current ruby version is 2.6.10.210.
    – TD540
    Commented Mar 19, 2023 at 6:58
100

For macOS:

brew install --cask cocoapods

Original answer (outdated):

brew install cocoapods
brew cask install cocoapods-app
7
  • 7
    Error: Cask 'cocoapods-app' is unavailable: No Cask with this name exists.
    – user5683940
    Commented Aug 1, 2019 at 11:57
  • @rust brew cask search cocoapod? I don’t know.
    – HappyFace
    Commented Aug 1, 2019 at 14:12
  • 12
    brew install --cask cocoapods installs both the command line tool and the app.
    – Dirk
    Commented Dec 15, 2020 at 16:30
  • @Dirk Thanks, that's the best solution for MacOS
    – abhy
    Commented Dec 17, 2020 at 4:22
  • brew install --cask cocoapods installs outdated version 1.5.2.
    – kelin
    Commented Sep 28, 2022 at 14:08
99

Installing CocoaPods on OS X 10.11

These instructions were tested on all betas and the final release of El Capitan.

Custom GEM_HOME

This is the solution when you are receiving above error

$ mkdir -p $HOME/Software/ruby
$ export GEM_HOME=$HOME/Software/ruby
$ gem install cocoapods
[...]
1 gem installed
$ export PATH=$PATH:$HOME/Software/ruby/bin
$ pod --version
0.38.2
1
  • 1
    Did not work for me. When I try "gem install cocopods" I get the error "activesupport requires Ruby version >= 2.2.2."
    – Zvi
    Commented Sep 9, 2016 at 22:20
55

You have to restart Terminal after installing the gem. Or you can simply open a new tab Terminal to fix.

2
  • 3
    I did it but nothing had changed still it doesn't recognize my pod command I had installed cocoapods
    – Nickool
    Commented Oct 13, 2013 at 9:38
  • 3
    Alternatively, you can call . ~/.profile which will setup your ruby env again.
    – yincrash
    Commented Dec 17, 2013 at 0:11
47

for M1mac people first install cocoapods

brew install cocoapods  

and if you are doing this for ios react-native

pod install
1
  • 1
    This worked for me! I made a mistake by installing it using gem and it caused many linking issues
    – GeekDev
    Commented Jan 9 at 22:48
16

I had the same problem, running Mountain Lion with Ruby 2 installed and used instead of system ruby.

Previously I added PATH=/usr/local/bin:$PATH to my ~/.bash_profile as a way to make sure stuff installed by homebrew, including Ruby 2, took precedence over system-installed binaries.

Anyway, in this case I noticed that cocoapods would install their 'pod' binary not in /usr/local/bin but rather in /usr/local/Cellar/ruby/2.0.0-p247/bin/

So to my .bash_profile I added PATH=$PATH:/usr/local/Cellar/ruby/2.0.0-p247/bin/ and now cocoapods is working like a charm.

4
  • I do not have this path file what should I do to follow?
    – Nickool
    Commented Oct 13, 2013 at 9:49
  • I'm pretty sure you should have a .bash_profile, you can't normally see it because of the . in front of the file name. do first a plain cd in your terminal to go back to your home dir followed b a ls -a, you should see all your files including a bash_profile
    – gterzian
    Commented Oct 16, 2013 at 20:59
  • 1
    Thanks for tip. I soft linked the pod executable to /usr/local/bin, now everythings seem to be ok.
    – Liqun
    Commented Oct 16, 2013 at 23:25
  • 1
    It is not ideal to hardcode the ruby version into the PATH. See this answer for how to do this generically: stackoverflow.com/a/14138490/1531256 Commented Jan 22, 2014 at 13:20
15

Try this:

sudo gem install cocoapods -V

and you must update gem to the newest release using this:

sudo gem update --system 

if you want to enjoy the fast responce :)

0
15
  1. Uninstall all instances of cocopods by this command

    $sudo gem uninstall cocoapods
    
  2. sudo gem install -n /usr/local/bin cocoapods

  3. sudo chmod +rx /usr/local/bin/

3
  • What does chmod +rx do? Commented Oct 31, 2016 at 14:13
  • ERROR: While executing gem ... (Gem::FilePermissionError) You don't have write permissions for the /usr/local/bin directory. But your process worked :) Commented Mar 28, 2017 at 11:52
  • Nice use of the -n option. Commented Apr 3, 2019 at 17:56
12

Sudo-less installation

If you do not want to grant RubyGems admin privileges for this process, you can tell RubyGems to install into your user directory by passing either the --user-install flag to gem install or by configuring the RubyGems environment. The latter is in our opinion the best solution. To do this, create or edit the .profile file in your home directory and add or amend it to include these lines:

export GEM_HOME=$HOME/.gem
export PATH=$GEM_HOME/bin:$PATH

Note that if you choose to use the --user-install option, you will still have to configure your .profile file to set the PATH or use the command prepended by the full path. You can find out where a gem is installed with gem which cocoapods. E.g.

$ gem install cocoapods --user-install
$ gem which cocoapods
/Users/eloy/.gem/ruby/2.0.0/gems/cocoapods-0.29.0/lib/cocoapods.rb
$ /Users/eloy/.gem/ruby/2.0.0/bin/pod install

Source: https://guides.cocoapods.org/using/getting-started.html

11

try: rbenv global system and then sudo gem install cocoapods pod setup

3
  • This worked for me using rbenv global system. Typing simply rbenv system results in an error.
    – user1078170
    Commented Mar 27, 2015 at 18:06
  • @MCSD Your should install rbenv first.
    – Allen
    Commented Jan 23, 2019 at 15:25
  • Issue - rbenv: pod: command not found react-native -> above solution work for me Commented Mar 24, 2022 at 7:18
9

In terminal it's better to run installation of the cocoa pods with "sudo". In other case I'm getting an error: "You don't have write permissions for the /Library/Ruby/Gems/2.0.0 directory."

So the solution is:

sudo gem install cocoapods
6

so I also had the same problem. This is probably happening because your computer has an older version of ruby. So you need to first update your ruby. Mine worked for ruby 2.6.3 version.I got this solution from sStackOverflow,

You need to first open terminal and put this code

curl -L https://get.rvm.io | bash -s stable

Then put this command

rvm install ruby-2.6

This would install the ruby for you if it hasn' t been installed.After this just update the ruby to the new version

rvm use ruby-2.6.3

After this just make ruby 2.6.3 your default

rvm --default use 2.6.3

This would possibly fix your issue. You can now put the command

sudo gem install cocoapods

And the command

pod setup

I hope this was useful

4

I tried all the above, but this worked for me, and if you are using the latest Xcode this will also work for you:

sudo gem install cocoapods

Got Error:

In Case sudo gem install cocoapods is not working for you, then you can follow these steps.

Error installing cocoapods:
The last version of drb (>= 0) to support your Ruby & RubyGems was 2.0.6.
drb requires Ruby version >= 2.7.0. The current ruby version is 
 2.6.10.210.

Then Try installing it with sudo gem install drb -v 2.0.6 and then running the current command again.

Again Erro After running the above commands if you get the error again! saying that:

 Error installing cocoapods:
The last version of activesupport (>= 5.0, < 8) to support your Ruby & 
RubyGems was 6.1.7.7.

Try installing it with sudo gem install activesupport -v 6.1.7.7 and then running the current command again

sudo gem install activesupport -v 6.1.7.7

sudo gem install cocoapods

Now it will work for you. Happy Coding

I hope this will work for you.

4

For Mac(M1) users:

Install cocoapods using brew instead of gem.

brew install cocoapods

and then

cd ios && pod install
1
  • Please use code snippet to separate description with solution. Commented Jun 24 at 11:02
3

This solution worked for me. Make sure to not miss the last command (export PATH=$PATH:$HOME/Software/ruby/bin).

See This.

3

install cocoapods from https://cocoapods.org/app

Commands & versions keep onchanging

so download tar and enjoy

3

It works for me:

brew update cocoapods
brew link cocoapods
2

gterzian is on the right track, however, if you later update your version of ruby then you'll also have to update your .profile to point to the new versioned ruby directory. For instance, the current version of ruby is 2.0.0-p353 so you'd have to add /usr/local/Cellar/ruby/2.0.0-p353/bin to your path instead.

A better solution is to add /usr/local/opt/ruby/bin to your PATH. /usr/local/opt/ruby is actually a symlink to the current version of ruby that homebrew automatically updates when you do an upgrade. That way you'll never need to update your PATH and always be pointing to the latest version.

2

it happens to me when I wrote

gem install cocoapods

instead of

sudo gem install cocoapods

if sudo command is not found also, write

export PATH=/usr/bin:/bin:/usr/sbin:/sbin:/usr/local/bin:$PATH

before sudo command

2

If you used homebrew to install ruby, this answer worked for me.

brew unlink ruby && brew link ruby

OSX 10.9.4

2

@Babul Prabhakar was right

IMPORTANT: However,if you still get "pod: command not found" after using his solution, this command could solve your problem:

sudo chown -R $(whoami):admin /usr/local
2

Please remove the Ruby folder from -Your Disk->Library->Ruby Deleting this folder and use sudo gem install cocoapods command to solve my issue. enter image description here

1
  • Not work around Commented Feb 10, 2022 at 8:36
2

CocoaPods is built with Ruby and it will be installable with the default Ruby available on macOS. You can use a Ruby Version manager, however we recommend that you use the standard Ruby available on macOS unless you know what you're doing.

sudo gem install cocoapods

Resource: https://guides.cocoapods.org/using/getting-started.html

2

If you ever delete pod file from /usr/local/bin with terminal or any sudo,
you will need to install it to your bin folder,
so use:

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

after

sudo gem install cocoapods

do

pod setup

then open new tab, check version of pod

pod --version
1
  • Thank you for your interest in contributing to the Stack Overflow community. This question already has quite a few answers—including one that has been extensively validated by the community. Are you certain your approach hasn’t been given previously? If so, it would be useful to explain how your approach is different, under what circumstances your approach might be preferred, and/or why you think the previous answers aren’t sufficient. Can you kindly edit your answer to offer an explanation? Commented Aug 26, 2023 at 23:23
1

I'm using OS Catalina and used the solution of Babul Prabhakar. But when I closed the terminal, pod still was unable.

So I put the exports:

$ export GEM_HOME=$HOME/Software/ruby
$ export PATH=$PATH:$HOME/Software/ruby/bin

inside this file(put this command below inside the terminal):

nano ~/.bash_profile

Then save the file, close the terminal and open it up again and type:

pod --version
1

The best solution for Big Sur is posted on Redit by _fgmx

Go into Xcode 12 preferences Click locations Select Xcode 12 for Developer tools/command line tools Install cocoapods for Xcode 12: sudo gem install cocoapods

1

This worked for me

sudo apt-get install ruby-dev
sudo gem install cocoapods
1

try sudo gem install -n /usr/local/bin cocoapods -v 1.8.4

then once cocoapods is successfully installed, try pod command again.

Not the answer you're looking for? Browse other questions tagged or ask your own question.