All threads / Setup MacOS 10.11 El Capitan Discussion
Ask A Question


You’re not receiving notifications from this thread.

Setup MacOS 10.11 El Capitan Discussion

Chris Oliver asked in General

Stop confusing people, there is a big problems with homebrew and El Capitan

had no problems

Orly? Homebrew works fine?

yea works fine for me

brew working for me but facing an issue while installing Rails

its shows an error like hile executing gem ... (Errno::EACCES)

Permission denied - /Library/Ruby/Gems/2.0.0/gems/nokogiri-

in the terminal

Zasheek Tamaris ·

try running
"xcode-select --install"
next you can run
"gem install rails -v 4.2.4"

Also for me.

Talal Alobaid ·

Both brew and brew cask are working fine for me.

Nenad Novakovic ·

If it had any problems before, it does not have any problems now.
Homebrew is brewing fine with El Capitan!

Debjit Saha ·


Debjit Saha ·

Yes, the issues were due to OS X El Capitan's new feature called System Integrity Protector. I have outlined a quick and easy fix here -

I don't see any issues with homebrew, brew install // brew cask install etc and El Capitan

Indeed it works fine now, but not 4 month ago.
You have to fix permissions to /usr/local, update brew and
do xcode-select in case of upgrading OSX though!

On my mac, you are right

Thanks. This worked great. The one thing I did find is that after installing mysql I rebooted as I could not invoke mysql at the command line. Other than that works great! Thanks!

Awesome post :)
Looks like really clean installation.

I failed at rbenv install 2.2.0:

BUILD FAILED (OS X 10.11 using ruby-build 20150719)

Kameron A Robinson ·

I had a problem installing rails got back "extconf failed, exit code 1"

antonioreyna ·

hello, when i do ruby -v i get 2.0.0 but when i do rbenv version i get 2.2.3 is that ok?

Антон Машошин ·

it seems that you already tryed to install ruby via brew... try "brew uninstall ruby". i had the same problem, after that i got right ruby version

Alejandro Ventura ·

Cool it works for me now!
What do I need to do to change the password if the user is my computers username? And how to turn it on/off when I want to?

Did u disabled SIP on OSX El Capitan?

Alejandro Ventura ·

No! I don't I just run the commands written in the blog and thats it

Alejandro Ventura ·

Is there a PrefPane for Postgresql in Mac OS like the Mysql one? I don't want the server runs at start up

Instead of homebrew you could use which only runs when you launch the app.

Alejandro Ventura ·

But I have read that Ruby on Rails don't work fine because of the "c" libraries that postgresql need to communicate with the gem. Those libraries are not installed using the app, you need to run the installer in order to install those libraries in the shell.
What about that?

Works fine here with rails 4 and the pg gem. Just follow the documentation.

Alejandro Ventura ·

Alright I will check! Thanks for your support!

I've had a quick look at the docs and think this is the page you need.

Basically you need to add the .app to your $PATH (as the docs show in a page it links to). That's the only setup I remember doing here. The nice thing about this method is you don't have to do any arcane account setup to get something working (for local development). pg_restore and similar also become available in the terminal, since they're now on your path.

Just remember not to use sudo to install the gem (as that page suggests) because it'll mess with the permissions in your rbenv install, which should be in your user account & not need sudo (fixable with something like sudo chown -R $(whoami) ~/.rbenv)

Alejandro Ventura ·

Thanks brother!

i am facing a problem while installing Rail (gem install rails -v 4.2.4)

its shows an error like while executing gem ... (Errno::EACCES)

Permission denied - /Library/Ruby/Gems/2.0.0/gems/nokogiri-

in the terminal
any one suggest me a solution

Drew Garcia ·

I don't know the benefit to using rbenv vs rvm but I uninstalled Rbenv, bc I was having similar issues. Installed RVM and everything is working.

It looks like either rbenv isn't installed properly, e.g. missing from your .profile or .bashrc or whatever, or it's installed but you haven't told it to use a ruby version other than your system ruby (which would install to /Library/Ruby and require sudo permissions). Install another ruby with the rbenv ruby-build plugin (also available through homebrew) and use rbenv local to switch a particular project directory to use that ruby version (it creates a .ruby-version file in the directory).

I'm having difficulties on El Capitan. I'm following the instructions here. But I'm stuck on the last step here.

The command "rails server", is returning an error.

"Could not find pg-0.18.3 in any of the sources

Run `bundle install` to install missing gems."

I have ran "bundle install" and when I try to run "rails server", I get the same error again.

Worked perfectly for me on El Capitan 10.11.

Peter Peťuldo Mihok ·

I always get this error message, when I open this local host web page:
Specified 'mysql2' for database adapter, but the gem is not loaded. Add `gem 'mysql2'` to your Gemfile (and ensure its version is at the minimum required by ActiveRecord).

Peter, you need to open yourapp/Gemfile with any texteditor or ide you like, and add string: gem 'mysql2' to your Gemfile, it's easy.

Peter Peťuldo Mihok ·

It's written there, but still not working.

Use the "bundle install" command in your app folder to run the Gems installation ;)

Peter Peťuldo Mihok ·

Ok, here's my problem. After finishing this whole installation and after all these advices you gave me here I want to run my rails server command. After this command I click here on this localhost:3000 and it says the same error as I mentioned up there....So Idk if it's just the error of the localhost, or I did mistake somewhere else.

But thanks guys for helping me...I'm really frustrated with just installing this ruby and it really keeps me away from wanted to learn this, cause it's not running as it should.

You now have to give Rails informations about you database in your database.yml file.
I suggest you to watch the "How to deploy Ruby on Rails" video, you'll learn valuable things about all of this!

Anyway, in the database.yml, you can tell Rails where to find your database and how to access it.
Pay attention you can run in few environments, so you have to specify default informations, or informations for each environment.
It will look like this :

adapter: mysql2
encoding: utf8
database: my_db_name
username: root
password: my_password
port: 3306

Peter Peťuldo Mihok ·

Thanks mate. OK I tried to reinstall whole ruby on rails and I also got the same error. Everything went OK untill I had to write rake db:create after this command I've got this error message:

Gem::LoadError: Specified 'mysql2' for database adapter, but the gem is not loaded. Add `gem 'mysql2'` to your Gemfile (and ensure its version is at the minimum required by ActiveRecord).

Gem::LoadError: can't activate mysql2 (~> 0.3.13), already activated mysql2-0.4.2. Make sure all dependencies are added to Gemfile.

I looked to my Gemfile and there's written gem 'mysql2', so I don't know where the problem is.

Srozen maybe, if you can give me your e-mail/skype/FB and we can talk about it in details, it'd help me a lot.

It's a known bug, change the following in your Gemfile

gem 'mysql2'


gem 'mysql2', '~> 0.3.10'

and then use "bundle install" in command prompt

bog_weasel ·

Was your mysql server running? I get the same error if I don't run 'mysql.server start' before 'rails server'.

The only thing that worries me is that I have to use "sudo" for the installation. I'm hoping this is understood, and not included for clarity.

You shouldn't ever have to use sudo for this. If you do, you're going to end up with permissions errors later on. Homebrew might in order to change permissions for some of its own folders where you install apps from, but the rest of it shouldn't ever use sudo.

Kenny Mann ·

If you have XCode installed then run this BEFORE you try to install rails (or you'll keep running into errors):
xcode-select --install

I took this from:

I forgot to add what's going on. You need the command line tools and that's what this installs.

I ran the rails app and it doesn't seem to have any errors but when I go to the "localhost:3000" site, it tells me that, "This webpage is not available." Is there any other way to see if the database actually ran? Thanks.

I upgraded to El Capitan with homebrew already installed. I found that I had to remove the old version of homebrew and then reinstall it, run brew doctor (correct any errors) and then I was good to go!

I tried doing this a few weeks ago and ended up messing up the bash file. Fast forward to know, when I go to do the first step the first thing I get is:

"-bash: l: command not found"

can I reset the "bash"? I am quite new to this and not sure how to properly use the terminal.
Thanks in advance for any advice


When visit localhost:3000

I'm greeted with error: Specified 'mysql2' for database adapter, but the gem is not loaded. Add `gem 'mysql2'` to your Gemfile (and ensure its version is at the minimum required by ActiveRecord).

I'm a new user, and not sure how to proceed.

Was able to find a fix via

It's currently an issue with Rails 4.1.x and 4.2.x, per this bug report, it will be fixed in the next release of rails 4.2.x (credit to dcorr in comments for the link).
In the mean time you can fix by doing downgraded to version 0.3.18 of mysql2 by adding this line to your gemfile:

gem 'mysql2', '~> 0.3.18'

I'm having an issue with
# Load rbenv automatically by adding

# the following to your profile:

eval "$(rbenv init -)"

popping up every time I open up iTerm/Terminal

Rinaldo Bonazzo ·

Thanks a lot for your help

nissandookeran ·

There's a bug I encountered when following the instructions for setting up with mysql. Wrote the fix steps at (really just need to update RubyGems and then run 'gem update' to upgrade to rails 2.4.5, which I think fixes the issue)

raulsergioUS ·

This link helps me a lot with El Capitan

James Jackson ·

Same here, worked like a dream on El Capitan v10.11.1

Tomo Okabe ·

thank you! was really helpful.
the only part that i had a difficulty was that when installing rails, the terminal stopped for a bit so i thought it was causing some problems... :( But worked perfectly and it was so easy to get everything sorted! Thank you so much

João Reis ·

Thanks for the good instructions. I would recommend to install postgres from the for mac: and get pgAdmin3 app for mac for querys and stuff:

I have created a video based on this guide at:

Awesome documentation! Thanks!

why isn't there rvm installation guide?

I keep getting the following error...

-bash: /Users/macpro/.bash_profile: line 6: syntax error near unexpected token `source'
-bash: /Users/macpro/.bash_profile: line 6: `if which rbenv > /dev/null; then eval "$(rbenv init -)"; fi source /Users/macpro/.bash_profile'

...when trying to run the code to add rbenv to bash. Help please!!

I may have installed newer versions of ruby first before running this code. Not sure if that would complicate things.

Did you get this fixed? i too am getting this error

Your ~/.bash_profile should just have one line that is that same as what's in the single quotes on that first line.

if which rbenv > /dev/null; then eval "$(rbenv init -)"

Looks like he had accidentally combined those two commands to run on accident.

Hi Chris,
Could we get the page updated to be a bit clearer?

I'm still not 100% what I need to do in that step. Or should I just edit the .bash_profile file?

You should just copy and paste each line into your terminal and run each one. Make sure that your copy/paste didn't mess up the command during the paste. I'm not sure what's causing you guys to get malformed commands.

Not sure mate, that's all I did. Copied the first line. Pasted. Hit enter.
Then copied the second line. Pasted that. Hit enter again. It's this bit that brings up the error

I saw on stack overflow someone mentioned a ; after the fi

If your error was like his, it is showing that the "source" line also got copied into the file, so the ending single quote didn't get applied right most likely to close the string. Not having an ending semicolon is fine (just tested it again). Sometimes when pasting stuff into terminal there are weird things that cut off lines short or your browser can mess with quotes and make them curly when they should be straight (http://practicaltypography.... That shouldn't happen in a code block though. I can't reproduce the issue you guys are having with Chrome and both iTerm and Terminal so not entirely sure what's wrong for you guys, but it's one of these things.

@excid3:disqus i opened up my .bash_profile and it had that line multiple times I removed them and I added the one you mentioned above and i get an error - -bash: .bash_profile: line 2: syntax error: unexpected end of file

If you haven't fixed your error, is the problem. When you first followed the installation steps, you most likely copied the two lines of code incorrectly. However, now the incorrect code is save in your .bash_profile. Every time you open your terminal it's calling the .bash_profile and generating an error. Your error says that line 2 has a syntax error. To fix it, you need to open the .bash_profile file delete the incorrect code.

Follow these steps on how to edit the bash profile. Only remove the lines of code pertaining to this install. Save it, close it, and run the two lines of code again (you could just type it in also).

Line 1: 'if which rbenv > /dev/null; then eval "$(rbenv init -)"; fi' >> ~/.bash_profile
Line 2: source ~/.bash_profile

Hope that helps.

Hey Jesica :) thanks. I found these instructions worked a litter easier

Enter the following in your terminal window

$ touch ~/.bash_profile; open ~/.bash_profile

In the text editor window that opens add the following code:
which rbenv > /dev/null; then eval "$(rbenv init -)"

Saved your .bash_profile

Ningchuan Li ·

# To have launchd start mysql at login:

ln -sfv /usr/local/opt/mysql/*plist ~/Library/LaunchAgents

I think current is
ln -sfv /usr/local/opt/mysql/*.plist ~/Library/LaunchAgents

Please help me if you had same problem like this. I have a problem with this code "ssh -T". When I put this line of code I received this:

that's because you're in the wrong folder and github doesn't find the publickey, so what you need to do is find the right path, then try again and it will works, at least for me, that was the solution.

William ·

Works great! :)

YiLong Liu ·

Hello guys I hope you are having a good day, I'm accessing to Localhost:3000 , It seems everything is installed correctly, but after I run rails server and copy and paste the url the following message is displayed: We're sorry, but something went wrong(500), do you know what is the reason of this?

Saurabh Agrawal ·

How to install rails gem without docs? Also how to make that default?

How do you install in China?

ERROR: While executing gem ... (Gem::RemoteFetcher::FetchError)

too many connection resets (

Keep getting this

The Marionettist ·

Thanks! Cheers!

Great set-up guidance here for a rapid deployment... took less than 30 for me; by about 2 minutes.

Moritz von Haacke ·

Great tutorial

Kaan L Caglar ·

Works like a charm! Thanks.

John Habibi ·

Great walk through! I had to side step over to github to makes sense of establishing a new SSH key, but overall A+++

Awesome guide, worked like a charm on El Capitan and getting Postgre setup straightaway rather than having that oh S*** moment as I try to deploy to heroku next time was a good finishing touch. Thanks.

Alejandro Pelaez ·

Muchas gracias. Funcionó muy bien en El Capitan 10.11

Shannon Moon ·

Rails install failed for me on a new install of el capitan (10.11.6) with this error: libiconv is missing. please visit for help with installing dependencies. I installed nokogiri with gem install nokogiri and then was able to successfully install rails and proceed with the installation.

Thks for the tutorial but when el open the terminal, it display this

Last login: Sun Aug 7 21:52:21 on ttys000
-bash: /Users/MacBookPro/.bash_profile: line 3: syntax error near unexpected token `source'
-bash: /Users/MacBookPro/.bash_profile: line 3: `if which rbenv > /dev/null; then eval "$(rbenv init -)"; fi source /Users/MacBookPro/.bash_profile'
MacBook-Pro-de-MacBook:~ MacBookPro$

how can I revert or fix it?


Nadeem Jabbar Qureshi ·

In El Capitan, you might also need to do `sudo gem install bundler -n /usr/local/bin´.

Please see:

I received the error detailed in the last part of the tutorial, but am unclear on how to update the config/database.yml file

Uladzislau ·

Hey hey! Some tips:

Configuring Git section.
after generating ssh-key you need to do:
eval "$(ssh-agent -s)"
ssh-add ~/.ssh/id_rsa
check this by ssh-add -l

and the following text after cat ~/.ssh/
add it to your ssh-key in GitHub account.

cause I were bound by Permission denied problem without this actions

Still working on OSX 10.11 El Capitan! Tnx!

So, for me 'gem install rails -v 4.2.6' yielded the error 'ERROR: Error installing rails: ERROR: Failed to build gem native extension.' What fixed it was installing xcode commadline tools with 'xcode-select --install'. Maybe you can add this information to the post or open a troubleshoot section.

Evert Smit ·

Can anybody help me as i want to install Homebrew and ruby on rails on my Macbook OSX 10.8.5 2 months back i still could install homebrew but now it gives the following error.

Last login: Sat Oct 29 15:02:30 on ttys000

mrrobotas-MacBook-Pro:~ mrrobota$ /usr/bin/ruby -e "$(curl -fsSL https://raw.githubusercontent...."

curl: (22) The requested URL returned error: 404

mrrobotas-MacBook-Pro:~ mrrobota$

Unable to install rails - getting the following error: ERROR: Error installing rails:
activesupport requires Ruby version >= 2.2.2.
New to this stuff, has anyone had the same issue?

Hi Nat! did you solve this issue? seems that version 2.4.0 was installed in ~/.rbenv, and when i call `ruby -v`, it references an installation in /usr/bin/ruby

Thank you so much.

hannah lee ·

Thanks a lot. It worked fine :D

Mounika Smitha ·

Best tutorial for beginners.

Mounika Smitha ·

Best tutorial for beginners!

Thumbs up.It worked perfectly

Anto Boalis ·

all steps followed till the creation of SSH key. I put your command into Terminal, but nothing happens:

cat ~/.ssh/

Join the discussion

Want to stay up-to-date with Ruby on Rails?

Join 68,326+ developers who get early access to new tutorials, screencasts, articles, and more.

    We care about the protection of your data. Read our Privacy Policy.

    logo Created with Sketch.

    Screencast tutorials to help you learn Ruby on Rails, Javascript, Hotwire, Turbo, Stimulus.js, PostgreSQL, MySQL, Ubuntu, and more. Icons by Icons8

    © 2022 GoRails, LLC. All rights reserved.