Skip to content

HTTPS clone URL

Subversion checkout URL

You can clone with
or
.
Download ZIP
Newer
Older
100644 62 lines (39 sloc) 2.615 kB
3e63a35 @indirect Clean up README, factor out ISSUES
indirect authored
1 # Bundler Issues
2
fe20ecb @indirect discuss REE+gzip and spork+rake in ISSUES
indirect authored
3 ## Frequently encountered issues
4
5 ### REE and Zlib::GzipFile::Error
6
7 Ruby Enterprise Edition users may see a `Zlib::GzipFile::Error` while installing gems. It is due to [a bug in REE](http://code.google.com/p/rubyenterpriseedition/issues/detail?id=45). You may be able to resolve the issue by upgrading REE, or changing to a different interpreter.
8
9 ### Rake activation error
10
571e3e9 @indirect Update spork issue fix with versions
indirect authored
11 Anyone who has installed the Spork gem may see activation errors while running `rake` directly. This is because old versions of Spork would [install the newest rake using a mkmf file](https://github.com/timcharper/spork/issues/119). To resolve the issue, update the Spork version requirement in your Gemfile to at least `"~>0.8.5"` or `"~>0.9.0.rc8"`.
fe20ecb @indirect discuss REE+gzip and spork+rake in ISSUES
indirect authored
12
3e63a35 @indirect Clean up README, factor out ISSUES
indirect authored
13 ## Troubleshooting
14
2e6fcbd @indirect Update issues with better instructions
indirect authored
15 Instructions for common Bundler use-cases can be found on the [Bundler documentation site](http://gembundler.com/v1.0/).
16
17 Detailed information about each Bundler command, including help with common problems, can be found in the [Bundler man pages](http://gembundler.com/man/bundle.1.html).
d792117 @indirect Add links to helpful documentation in ISSUES
indirect authored
18
19 After reading the documentation, try these troubleshooting steps:
3e63a35 @indirect Clean up README, factor out ISSUES
indirect authored
20
a6a3d12 @indirect Expand ISSUES to explain each deletion
indirect authored
21 # remove user-specific gems and git repos
22 rm -rf ~/.bundle/ ~/.gem/
23
fefc334 @indirect Delete bundler git repos while troubleshooting
indirect authored
24 # remove system-wide git repos and git checkouts
25 rm -rf $GEM_HOME/bundler/ $GEM_HOME/cache/bundler/
26
a6a3d12 @indirect Expand ISSUES to explain each deletion
indirect authored
27 # remove project-specific settings and git repos
28 rm -rf .bundle/
29
30 # remove project-specific cached .gem files
31 rm -rf vendor/cache/
32
33 # remove the saved resolve of the Gemfile
34 rm -rf Gemfile.lock
35
36 # try to install one more time
3e63a35 @indirect Clean up README, factor out ISSUES
indirect authored
37 bundle install
38
d792117 @indirect Add links to helpful documentation in ISSUES
indirect authored
39 ## Reporting unresolved problems
3e63a35 @indirect Clean up README, factor out ISSUES
indirect authored
40
2e6fcbd @indirect Update issues with better instructions
indirect authored
41 Instructions that allow the Bundler team to reproduce your issue are vitally important. When you report a bug, please include the following information:
3e63a35 @indirect Clean up README, factor out ISSUES
indirect authored
42
2e6fcbd @indirect Update issues with better instructions
indirect authored
43 - The command you ran
44 - Exception backtrace(s), if any
3e63a35 @indirect Clean up README, factor out ISSUES
indirect authored
45 - Your Gemfile
46 - Your Gemfile.lock
2e6fcbd @indirect Update issues with better instructions
indirect authored
47 - Your Bundler configuration settings (run `bundle config`)
48 - What version of bundler you are using (run `bundle -v`)
49 - What version of Ruby you are using (run `ruby -v`)
50 - What version of Rubygems you are using (run `gem -v`)
51 - Whether you are using RVM, and if so what version (run `rvm -v`)
dab9711 @indirect check for rubygem-bundler while troubleshooting
indirect authored
52 - Whether you have the `rubygems-bundler` gem, which can break gem binares
2e6fcbd @indirect Update issues with better instructions
indirect authored
53
3e63a35 @indirect Clean up README, factor out ISSUES
indirect authored
54
55 If you are using Rails 2.3, please also include:
56
57 - Your boot.rb file
58 - Your preinitializer.rb file
59 - Your environment.rb file
2e6fcbd @indirect Update issues with better instructions
indirect authored
60
61 [Create a gist](https://gist.github.com) containing all of that information, then visit the [Bundler issue tracker](https://github.com/carlhuda/bundler) and create a new ticket describing your problem and linking to your gist.
Something went wrong with that request. Please try again.