Error installing nokogiri: Failed to build gem native extension & libiconv is missing (OSX)

Question

I try to clone this repo and run bundle install. The bundle process failed and throw this error:

    ...
    Installing nokogiri 1.6.2.1 with native extensions
    Building nokogiri using packaged libraries.

    Gem::Ext::BuildError: ERROR: Failed to build gem native extension.

        /Users/zulhilmizainudin/.rvm/rubies/ruby-2.2.0/bin/ruby -r ./siteconf20151130-43880-pntnc6.rb extconf.rb
    Building nokogiri using packaged libraries.
    -----
    libiconv is missing.  please visit http://nokogiri.org/tutorials/installing_nokogiri.html for help with installing dependencies.
    -----
    *** extconf.rb failed ***
    Could not create Makefile due to some reason, probably lack of necessary
    libraries and/or headers.  Check the mkmf.log file for more details.  You may
    need configuration options.

    Provided configuration options:
        --with-opt-dir
        --without-opt-dir
        --with-opt-include
        --without-opt-include=${opt-dir}/include
        --with-opt-lib
        --without-opt-lib=${opt-dir}/lib
        --with-make-prog
        --without-make-prog
        --srcdir=.
        --curdir
        --ruby=/Users/zulhilmizainudin/.rvm/rubies/ruby-2.2.0/bin/$(RUBY_BASE_NAME)
        --help
        --clean
        --use-system-libraries
        --enable-static
        --disable-static
        --with-zlib-dir
        --without-zlib-dir
        --with-zlib-include
        --without-zlib-include=${zlib-dir}/include
        --with-zlib-lib
        --without-zlib-lib=${zlib-dir}/lib
        --enable-cross-build
        --disable-cross-build

    extconf failed, exit code 1

    Gem files will remain installed in /Users/zulhilmizainudin/.rvm/gems/ruby-2.2.0/gems/nokogiri-1.6.2.1 for inspection.
    Results logged to /Users/zulhilmizainudin/.rvm/gems/ruby-2.2.0/extensions/x86_64-darwin-14/2.2.0-static/nokogiri-1.6.2.1/gem_make.out
    An error occurred while installing nokogiri (1.6.2.1), and Bundler cannot continue.
    Make sure that `gem install nokogiri -v '1.6.2.1'` succeeds before bundling.

Then I try to run this:

gem install nokogiri -v '1.6.2.1'

And now I get this error:

Building native extensions.  This could take a while...
Building nokogiri using packaged libraries.
ERROR:  Error installing nokogiri:
    ERROR: Failed to build gem native extension.

    /Users/zulhilmizainudin/.rvm/rubies/ruby-2.2.0/bin/ruby -r ./siteconf20151130-43942-1axq4sj.rb extconf.rb
Building nokogiri using packaged libraries.
-----
libiconv is missing.  please visit http://nokogiri.org/tutorials/installing_nokogiri.html for help with installing dependencies.
-----
*** extconf.rb failed ***
Could not create Makefile due to some reason, probably lack of necessary
libraries and/or headers.  Check the mkmf.log file for more details.  You may
need configuration options.

Provided configuration options:
    --with-opt-dir
    --without-opt-dir
    --with-opt-include
    --without-opt-include=${opt-dir}/include
    --with-opt-lib
    --without-opt-lib=${opt-dir}/lib
    --with-make-prog
    --without-make-prog
    --srcdir=.
    --curdir
    --ruby=/Users/zulhilmizainudin/.rvm/rubies/ruby-2.2.0/bin/$(RUBY_BASE_NAME)
    --help
    --clean
    --use-system-libraries
    --enable-static
    --disable-static
    --with-zlib-dir
    --without-zlib-dir
    --with-zlib-include
    --without-zlib-include=${zlib-dir}/include
    --with-zlib-lib
    --without-zlib-lib=${zlib-dir}/lib
    --enable-cross-build
    --disable-cross-build

extconf failed, exit code 1

Gem files will remain installed in /Users/zulhilmizainudin/.rvm/gems/ruby-2.2.0/gems/nokogiri-1.6.2.1 for inspection.
Results logged to /Users/zulhilmizainudin/.rvm/gems/ruby-2.2.0/extensions/x86_64-darwin-14/2.2.0-static/nokogiri-1.6.2.1/gem_make.out

I tried to follow this answer but I still get the same error above.

I also try to uninstall and install my brew again (based on this answer) and it's still same.

Also, I try this solution but still get the error.

What should I do now to make sure this nokogiri gem installed successfully?

Note: I'm using OSX 10.11.1 El Capitan.

Do you have already installed `xcode` ? What's the output of command `xcode-select --install` ? Also have you check the [nokogiri OSX installation instruction](http://www.nokogiri.org/tutorials/installing_nokogiri.html#mac_os_x)? — Roman Kiselenko, Nov 30 '15 at 10:42
Yes, I already install xcode and run `xcode-select --install`. The xcode developer tools installed successfully. — Zulhilmi Zainudin, Nov 30 '15 at 10:48

score 121 · Answer 1 · answered Jun 10 '16 at 21:49

121

Run these commands:

gem uninstall nokogiri
xcode-select --install
gem install nokogiri

source: http://www.nokogiri.org/tutorials/installing_nokogiri.html#mac_os_x

sometimes mac updates can break xcode CLI so reinstalling can fix the issue: https://github.com/sparklemotion/nokogiri/issues/1445

answered Jun 10 '16 at 21:49

pthamm

1,841
1
14
17

1

related answer: http://stackoverflow.com/questions/19643153/error-to-install-nokogiri-on-osx-10-9-maverick – zimkies Jul 20 '16 at 21:27
You are the best! Thank you for this! – kdweber89 May 18 '17 at 18:54
Thanks for this. I actually has to update my MacOS version to Catalina before `xcode-select --install` was allowed to run! – alex Jun 23 '20 at 09:24

score 32 · Answer 2 · edited May 23 '17 at 12:18

32

What worked for me (on macOS Sierra) was a combination of Sam's answer and the following:

gem install nokogiri -- --with-xml2-include=/Applications/Xcode.app/Contents/Developer/Platforms/MacOSX.platform/Developer/SDKs/MacOSX10.12.sdk/usr/include/libxml2 --use-system-libraries

edited May 23 '17 at 12:18

Community

1
1

answered Jan 05 '17 at 17:46

spencer.sm

19,173
10
77
88

1

This worked for me trying to install nokogiri -v 1.8.0 – margo Jun 21 '17 at 16:46
I used the same thing to install rails and it worked! Thanks. – Andre Simon Sep 21 '17 at 01:07
1

this worked for me, just make sure to confirm the folder because mine was /Applications/Xcode.app/Contents/Developer/Platforms/MacOSX.platform/Developer/SDKs/MacOSX10.13.sdk/usr/include/libxml2 – Emad Jan 11 '19 at 17:11

score 30 · Answer 3 · answered Mar 25 '16 at 22:55

30

I had a similar issue with 1.6.7.2 when bundle installing on codeship with ruby 2.3.

What worked for me was adding:

bundle config build.nokogiri --use-system-libraries

before

bundle install

answered Mar 25 '16 at 22:55

Jay

3,857
2
23
25

3

This is the best way to fix the problem in a more permanent solution. gem install nokogiri -v 1.6.6.2 -- --use-system-libraries – User128848244 Mar 07 '17 at 17:39
1

Yes, `gem install nokogiri -v 1.6.6 -- --use-system-libraries` seems to work – 0x4a6f4672 Oct 05 '20 at 12:02

score 20 · Answer 4 · answered May 11 '17 at 21:25

20

If you're using bundle:

brew install libxml2

# If using Bundle
bundle config build.nokogiri --use-system-libraries \
  --with-xml2-include=$(brew --prefix libxml2)/include/libxml2
bundle install

from http://www.nokogiri.org/tutorials/installing_nokogiri.html

answered May 11 '17 at 21:25

Andy Ray

30,372
14
101
138

Excellent, this is what worked for me on High Sierra after trying everything above. – Jimmy Huch Sep 13 '18 at 10:03
Wow. This is the only thing that worked for me. Thank you for sharing this Andy (all the way back in 2017 too!) – piratetone Jan 09 '20 at 03:09
Brilliant! Thank you. – Nuha May 19 '20 at 22:40

score 13 · Answer 5 · answered Apr 11 '19 at 07:42

13

Try this

sudo apt-get install build-essential patch ruby-dev zlib1g-dev liblzma-dev

And then install Nokogiri

sudo gem install nokogiri

answered Apr 11 '19 at 07:42

Lalana Chamika

607
12
17

1

cha-ching! thx for this. got me over the hump on `ubuntu 18.04` – WestCoastProjects Oct 18 '19 at 22:12
Avoid installing any ruby libraries. You should be using `rvm` and therefore `ruby-dev` is not needed to be installed. – aarona May 16 '20 at 20:36

Sam Selikoff · Answer 6 · 2016-10-18T12:02:56.610

10

I did everything in the other answers, but had to do one more thing:

Open Xcode
Click "Agree"
Wait a bit, close Xcode
Rejoice

edited Oct 18 '16 at 12:02

answered Oct 06 '16 at 20:55

Sam Selikoff

12,366
13
58
104

score 6 · Answer 7 · answered Nov 30 '15 at 10:58

6

Seems like this is due to nokogiri 1.6.2.1 specific problem.

I add this inside my Gemfile:

gem 'nokogiri', '~> 1.6', '>= 1.6.7'

And run bundle update nokogiri and then bundle. Everything now working fine.

answered Nov 30 '15 at 10:58

Zulhilmi Zainudin

9,017
12
62
98

score 2 · Answer 8 · answered Apr 29 '19 at 18:42

2

It may also be an issue with the anaconda version of some of the libs.

$ conda deactivate
$ gem uninstall nokogiri
$ gem install nokogiri
$ conda activate base

worked for me.

answered Apr 29 '19 at 18:42

Naupaka Zimmerman

46
3

score 1 · Answer 9 · answered Nov 10 '17 at 13:23

1

I had the similar issue. The reason was outdated xcode.

If you run brew doctor you might see it. Just open AppStore, got to updates tab and update your xcode.

answered Nov 10 '17 at 13:23

Alex Miasoiedov

11
4

`brew doctor` told me about newer Command Line Tools release and gave instructions on how to force update it. That solved the problem for me: `sudo rm -rf /Library/Developer/CommandLineTools && sudo xcode-select --install` – stacker-baka Oct 10 '21 at 10:09

Drew Jex · Answer 10 · 2020-01-09T23:36:47.993

1

Spencer's answer worked for me, but I also needed to use the -n parameter to overcome the permission issue documented here.

So in the end, the command that worked for me was:

gem install -n /usr/local/bin nokogiri -- --with-xml2-include=/Applications/Xcode.app/Contents/Developer/Platforms/MacOSX.platform/Developer/SDKs/MacOSX.sdk/usr/include/libxml2 --use-system-libraries

edited Jan 09 '20 at 23:36

answered Apr 17 '18 at 22:02

Drew Jex

845
2
13
24

1

NEVER install gems as sudo – Andy Ray Jan 09 '20 at 04:11

score 1 · Answer 11 · answered Mar 10 '19 at 11:10

1

If nothing above works, Try deleting Gemfile.lock, and do reinstalling of gems.

answered Mar 10 '19 at 11:10

Vineesh N P

29
5

1

You should be careful deleting `Gemfile.lock`. Not only will you reinstall the gems. But executing `bundle install` will update the versions of those gems – Christian Fazzini Mar 22 '20 at 10:41
Deleting the `Gemfile.lock` file helped me fix the issue after installing Nokogiri natively as instructed on [Nokogiri official website](https://nokogiri.org/tutorials/installing_nokogiri.html) – Angelo Igitego Dec 20 '21 at 19:24

score 0 · Answer 12 · answered Mar 11 '16 at 03:37

0

Deleting nokogiri in rbenv gem folder and reinstalling solved it for me.

answered Mar 11 '16 at 03:37

Kiryl Plyashkevich

2,157
19
18

score 0 · Answer 13 · edited Nov 02 '21 at 07:34

0

I had the same issue while updating to xcode 10. I resolved it with the following steps :

xcode-select --install
bundle install --deployment
gem install nokogiri

edited Nov 02 '21 at 07:34

developer01

311
2
6
20

answered Sep 19 '18 at 16:24

Ash

5,525
1
40
34

score 0 · Answer 14 · answered Mar 18 '19 at 08:17

0

This helped me fix this

I reinstalled Xcode and directed xcode-select to its path

sudo xcode-select -s /Applications/Xcode.app/Contents/Developer

ref: https://stackoverflow.com/a/17980786/3861525

answered Mar 18 '19 at 08:17

trojanh

97
9

score -1 · Answer 15 · edited Oct 01 '19 at 16:25

-1

Github Answer

sudo installer -pkg /Library/Developer/CommandLineTools/Packages/macOS_SDK_headers_for_macOS_10.14.pkg -target /

bundle install

edited Oct 01 '19 at 16:25

Dharman

30,962
25
85
135

answered Oct 01 '19 at 15:32

Arjun Sharma

1

Error installing nokogiri: Failed to build gem native extension & libiconv is missing (OSX)

15 Answers15

Linked