1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
151
152
153
154
155
156
157
158
159
160
161
162
163
164
165
166
167
168
169
170
171
172
173
174
175
176
177
178
179
180
181
182
183
184
185
186
187
188
189
190
191
192
193
194
195
196
197
198
199
200
201
202
203
204
205
206
207
208
209
210
211
212
213
214
215
216
217
218
219
220
|
<!DOCTYPE html>
<html>
<head>
<title>Bundler: The best way to manage a Ruby application's gems</title>
<meta content='text/html; charset=UTF-8' http-equiv='Content-Type'>
<meta content='276VSYOko8B8vIu1i8i5qbj7_ql5PXo0dU69XQy-SL' name='globalsign-domain-verification'>
<link href='/images/favicon.png' rel='shortcut icon' type='image/png'>
<link href="/stylesheets/application.css" media="screen" rel="stylesheet" type="text/css" />
</head>
<body>
<div id='body'>
<div id='header'>
<a class="image" href="/"><img width="725" alt="The best way to manage your application's dependencies" src="/images/gembundler.png" /></a>
</div>
<div id='container'>
<div id='contents'>
<h1 id="bundler-issues">Bundler Issues</h1>
<p>So! You're having problems with Bundler. This file is here to help. If you're running into an error, try reading the rest of this file for help. If you can't figure out how to solve your problem, there are also instructions on how to report a bug.</p>
<p><strong>Please use the <a href="https://github.com/bundler/bundler-features">Bundler
Features</a> repo to suggest and
discuss features. The bundler issue tracker is only for bugs.</strong></p>
<h2 id="documentation">Documentation</h2>
<p>Instructions for common Bundler uses can be found on the <a href="http://bundler.io/">Bundler documentation site</a>.</p>
<p>Detailed information about each Bundler command, including help with common problems, can be found in the <a href="http://bundler.io/man/bundle.1.html">Bundler man pages</a>.</p>
<h2 id="troubleshooting">Troubleshooting</h2>
<h3 id="heroku-errors">Heroku errors</h3>
<p>Please open a ticket with Heroku 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 can get the exact details to us.</p>
<h3 id="other-problems">Other problems</h3>
<p>First, figure out exactly what it is that you're trying to do. Then, go to the <a href="http://bundler.io">Bundler documentation website</a> and see if we have instructions on how to do that.</p>
<p>Second, check <a href="http://bundler.io/compatibility.html">the compatibility
list</a>, and make sure that the version of Bundler that you are
using works with the versions of Ruby and Rubygems that you are using.</p>
<p>If the instructions don't work, or you can't find any instructions, you can try these troubleshooting steps:</p>
<pre class="highlight plaintext"># remove user-specific gems and git repos
rm -rf ~/.bundle/ ~/.gem/bundler/ ~/.gems/cache/bundler/
# remove system-wide git repos and git checkouts
rm -rf $GEM_HOME/bundler/ $GEM_HOME/cache/bundler/
# remove project-specific settings
rm -rf .bundle/
# remove project-specific cached gems and repos
rm -rf vendor/cache/
# remove the saved resolve of the Gemfile
rm -rf Gemfile.lock
# uninstall the rubygems-bundler and open_gem gems
rvm gemset use global # if using rvm
gem uninstall rubygems-bundler open_gem
# try to install one more time
bundle install
</pre>
<h2 id="reporting-unresolved-problems">Reporting unresolved problems</h2>
<p>Hopefully the troubleshooting steps above resolved your problem. If things still aren't working the way you expect them to, please let us know so that we can diagnose and hopefully fix the problem you're having.</p>
<p><strong>The best way to report a bug is by providing a reproduction script.</strong> See these examples:</p>
<ul>
<li><a href="https://gist.github.com/xaviershay/6207550">Git environment variables causing install to fail.</a></li>
<li><a href="https://gist.github.com/xaviershay/6295889">Multiple gems in a repository cannot be updated independently.</a></li>
</ul>
<p>A half working script with comments for the parts you were unable to automate is still appreciated.</p>
<p>If you are unable to do that, please include the following information in your report:</p>
<ul>
<li>What you're trying to accomplish</li>
<li>The command you ran</li>
<li>What you expected to happen</li>
<li>What actually happened</li>
<li>The exception backtrace(s), if any</li>
<li>Everything output by running <code>bundle env</code></li>
</ul>
<p>If your version of Bundler does not have the <code>bundle env</code> command, then please include:</p>
<ul>
<li>Your Gemfile</li>
<li>Your Gemfile.lock</li>
<li>Your Bundler configuration settings (run <code>bundle config</code>)</li>
<li>What version of bundler you are using (run <code>bundle -v</code>)</li>
<li>What version of Ruby you are using (run <code>ruby -v</code>)</li>
<li>What version of Rubygems you are using (run <code>gem -v</code>)</li>
<li>Whether you are using RVM, and if so what version (run <code>rvm -v</code>)</li>
<li>Whether you have the <code>rubygems-bundler</code> gem, which can break gem executables (run <code>gem list rubygems-bundler</code>)</li>
<li>Whether you have the <code>open_gem</code> gem, which can cause rake activation conflicts (run <code>gem list open_gem</code>)</li>
</ul>
<p>If you are using Rails 2.3, please also include:</p>
<ul>
<li>Your boot.rb file</li>
<li>Your preinitializer.rb file</li>
<li>Your environment.rb file</li>
</ul>
<p>If you have either <code>rubygems-bundler</code> or <code>open_gem</code> installed, please try removing them and then following the troubleshooting steps above before opening a new ticket.</p>
<p><a href="https://gist.github.com">Create a gist</a> containing all of that information, then visit the <a href="https://github.com/bundler/bundler/issues">Bundler issue tracker</a> and <a href="https://github.com/bundler/bundler/issues/new">create a ticket</a> describing your problem and linking to your gist.</p>
<p>Thanks for reporting issues and helping make Bundler better!</p>
</div>
<div id='sidebar'>
<h2>Would you like to</h2>
<ul>
<li><a href="/#getting-started">Get started</a></li>
<li><a href="/issues.html">Report a bug</a></li>
<li><a href="/v1.6/whats_new.html">See what's new</a></li>
<li><a href="/v1.6/man/bundle.1.html">Read documentation</a></li>
<li><a href="/#get-involved">Discuss and Contribute</a></li>
<li><a href="/v1.6/faq.html">View FAQs</a></li>
</ul>
<div class='shirts'>
<div class='content'>
<p>
Bundler is developed entirely by a team of volunteers.
<a href="http://www.gittip.com/bundler">Support their work</a>
and help make Bundler better for everyone.
</p>
<p>
<script data-gittip-username='bundler' src='//gttp.co/v1.js'></script>
<br>
<br>
</p>
</div>
</div>
<h2>Bundler Commands</h2>
<ul>
<li><a href="/v1.6/bundle_install.html">bundle install</a></li>
<li><a href="/v1.6/bundle_update.html">bundle update</a></li>
<div class='buttons'>
<a href="/v1.6/commands.html">View all commands</a>
</div>
</ul>
<h2>Help With</h2>
<ul>
<li><a href="/v1.6/gemfile.html">Gemfiles</a></li>
<li><a href="/v1.6/groups.html">Groups</a></li>
<li><a href="/v1.6/git.html">Gems from git</a></li>
<li><a href="/v1.6/bundler_setup.html">Bundler.setup</a></li>
<li><a href="/v1.6/deploying.html">Deploying</a></li>
<li><a href="/v1.6/bundler_sharing.html">Sharing</a></li>
<li><a href="/v1.6/updating_gems.html">Updating Gems</a></li>
<li><a href="/compatibility.html">Compatible versions</a></li>
</ul>
<h2>Use Bundler with</h2>
<ul>
<li><a href="/v1.6/rails3.html">Rails 3</a></li>
<li><a href="/v1.6/rails23.html">Rails 2.3</a></li>
<li><a href="/v1.6/sinatra.html">Sinatra</a></li>
<li><a href="/v1.6/rubygems.html">Rubygems</a></li>
<li><a href="/v1.6/rubymotion.html">RubyMotion</a></li>
</ul>
<div class='shirts'>
<div class='content'>
<a class="image" onclick="ga('send', 'devswag');" href="http://www.devswag.com/collections/bundler"><img src="/images/bundler-shirt.png" />
</a>
<p>
<a onclick="ga('send', 'devswag');" href="http://www.devswag.com/collections/bundler">Buy Bundler Shirts & Stickers!</a>
</p>
</div>
</div>
</div>
</div>
</div>
<div id='footer'>
<img src="/images/emocow.png" />
<img src="/images/panda.jpg" />
<div class='spacer'></div>
<div id='credits'>
<p>
Many thanks to Bundler's <a href="/contributors.html">contributors</a>
and <a href="/sponsors.html">sponsors</a>
</p>
</div>
<div class='spacer'></div>
<img src="/images/bundler-small.png" />
</div>
<a href='http://github.com/bundler/bundler/' id='github'>
<img alt='Fork me on GitHub' src='http://s3.amazonaws.com/github/ribbons/forkme_right_darkblue_121621.png'>
</a>
<div id='prod-versions'>
Docs:
<a href="/v0.9/">v0.9</a>
<a href="/v1.0/">v1.0</a>
<a href="/v1.1/">v1.1</a>
<a href="/v1.2/">v1.2</a>
<a href="/v1.3/">v1.3</a>
<a href="/v1.5/index.html">v1.5</a>
<a class="current" href="/">v1.6</a>
</div>
<script>
(function(i,s,o,g,r,a,m){i['GoogleAnalyticsObject']=r;i[r]=i[r]||function(){
(i[r].q=i[r].q||[]).push(arguments)},i[r].l=1*new Date();a=s.createElement(o),
m=s.getElementsByTagName(o)[0];a.async=1;a.src=g;m.parentNode.insertBefore(a,m)
})(window,document,'script','//www.google-analytics.com/analytics.js','ga');
ga('create', 'UA-39559982-1', 'bundler.io');
ga('send', 'pageview');
</script>
</body>
</html>
|
