diff options
author | Homu <homu@barosl.com> | 2016-09-28 14:43:08 +0900 |
---|---|---|
committer | Homu <homu@barosl.com> | 2016-09-28 14:43:08 +0900 |
commit | 263fef26c467e577d2566330ce71b575663a5723 (patch) | |
tree | 849e11b46588ed7dd393d9cf8d29a64f11a5f2b2 | |
parent | c3b69668529ff9bbdd923f89fd0758418998dc37 (diff) | |
parent | b5c825905ea91b086f8aa91a02c08cd0e165869c (diff) | |
download | bundler-263fef26c467e577d2566330ce71b575663a5723.tar.gz |
Auto merge of #4991 - colby-swandale:installation-issues-documentation, r=indirect
added documentation for gem install bundler permission denied
This PR is for #4986. It adds documentation into ISSUES for when the user gets permission denied when installing bundler and a typical solution.
This will benefit users who are unfamiliar with unix and how to handle installing a system gem with elevated privileges.
-rw-r--r-- | ISSUES.md | 17 | ||||
-rw-r--r-- | README.md | 2 |
2 files changed, 19 insertions, 0 deletions
@@ -10,6 +10,23 @@ Detailed information about each Bundler command, including help with common prob ## Troubleshooting +### Permission denied when installing bundler + +Certain operating systems such as MacOS and Ubuntu have versions of Ruby that require evelated privileges to install gems. + + ERROR: While executing gem ... (Gem::FilePermissionError) + You don't have write permissions for the /Library/Ruby/Gems/2.0.0 directory. + +There are multiple ways to solve this issue. You can install bundler with elevated privilges using `sudo` or `su`. + + sudo gem install bundler + +If you cannot elevated your privileges or do not want to globally install Bundler, you can use the `--user-install` option. + + gem install bundler --user-install + +This will install Bundler into your home directory. Note that you will need to append `~/.gem/ruby/<ruby version>/bin` to your `$PATH` variable to use `bundle`. + ### Heroku errors Please open a ticket with [Heroku](https://www.heroku.com) if you're having trouble deploying. They have a professional support team who can help you resolve Heroku issues far better than the Bundler team can. If the problem that you are having turns out to be a bug in Bundler itself, [Heroku support](https://www.heroku.com/support) can get the exact details to us. @@ -19,6 +19,8 @@ bundle install bundle exec rspec ``` +For help with installation issues, see [ISSUES](https://github.com/bundler/bundler/blob/master/ISSUES.md) + See [bundler.io](http://bundler.io) for the full documentation. ### Troubleshooting |