summaryrefslogtreecommitdiff
path: root/v1.3/bundle_install.html
diff options
context:
space:
mode:
Diffstat (limited to 'v1.3/bundle_install.html')
-rw-r--r--v1.3/bundle_install.html176
1 files changed, 0 insertions, 176 deletions
diff --git a/v1.3/bundle_install.html b/v1.3/bundle_install.html
deleted file mode 100644
index 707756af51..0000000000
--- a/v1.3/bundle_install.html
+++ /dev/null
@@ -1,176 +0,0 @@
-<!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'>
- <h2>bundle install</h2>
- <div class='contents'>
- <div class='bullet'>
- <div class='description'>
- Make sure all dependencies in your Gemfile are available to your application.
- </div>
- <pre class="highlight plaintext">$ bundle install [--binstubs=PATH] [--clean] [--deployment] [--frozen]&#x000A; [--full-index] [--gemfile=FILE] [--local] [--no-cache]&#x000A; [--no-prune] [--path=PATH] [--quiet] [--shebang=STRING]&#x000A; [--standalone=ARRAY] [--system] [--without=GROUP GROUP]</pre>
- <div class='notes'>
- <p>
- Options:
- </p>
- <p>
- <code>--binstubs</code>: Generate bin stubs for bundled gems to ./bin
- </p>
- <p>
- <code>--clean</code>: Run bundle clean automatically after install
- </p>
- <p>
- <code>--deployment</code>: Install using defaults tuned for deployment environments
- </p>
- <p>
- <code>--frozen</code>: Do not allow the Gemfile.lock to be updated after this install
- </p>
- <p>
- <code>--full-index</code>: Use the rubygems modern index instead of the API endpoint
- </p>
- <p>
- <code>--gemfile</code>: Use the specified gemfile instead of Gemfile
- </p>
- <p>
- <code>--local</code>: Do not attempt to fetch gems remotely and use the gem cache instead
- </p>
- <p>
- <code>--no-cache</code>: Don't update the existing gem cache.
- </p>
- <p>
- <code>--no-prune</code>: Don't remove stale gems from the cache.
- </p>
- <p>
- <code>--path</code>: Specify a different path than the system default ($BUNDLE_PATH or $GEM_HOME). Bundler will remember this value for future installs on this machine
- </p>
- <p>
- <code>--quiet</code>: Only output warnings and errors.
- </p>
- <p>
- <code>--shebang</code>: Specify a different shebang executable name than the default (usually 'ruby')
- </p>
- <p>
- <code>--standalone</code>: Make a bundle that can work without the Bundler runtime
- </p>
- <p>
- <code>--system</code>: Install to the system location ($BUNDLE_PATH or $GEM_HOME) even if the bundle was previously installed somewhere else for this application
- </p>
- <p>
- <code>--without</code>: Exclude gems that are part of the specified named group.
- </p>
- </div>
- <div class='notes'>
- <p>
- Gems will be installed to your default system location for gems. If your
- system gems are stored in a root-owned location (such as in Mac OSX),
- bundle will ask for your root password to install them there.
- </p>
- <p>
- While installing gems, Bundler will check <code>vendor/cache</code> and then
- your system's gems. If a gem isn't cached or installed, Bundler will try to
- install it from the sources you have declared in your Gemfile.
- </p>
- <p>
- The <code>--system</code> option is the default. Pass it to switch back after
- using the <code>--path</code> option as described below.
- </p>
- </div>
- </div>
- <div class='bullet' id='path'>
- <div class='description'>
- Install your dependencies, even gems that are already installed
- to your system gems, to a location other than your system's gem
- repository. In this case, install them to <code>vendor/bundle</code>.
- </div>
- <div class='how'>
- <pre class="highlight plaintext">$ bundle install --path vendor/bundle</pre>
- <div class='notes'>
- Further <code>bundle</code> commands or calls to <code>Bundler.setup</code> or
- <code>Bundler.require</code> will remember this location.
- </div>
- <a href="/v1.3/bundler_setup.html">Learn More: Bundler.setup</a>
- <a href="/v1.3/groups.html">Learn More: Bundler.require</a>
- </div>
- </div>
- <div class='bullet' id='without'>
- <div class='description'>
- Install all dependencies except those in groups that are explicitly excluded.
- </div>
- <pre class="highlight plaintext">$ bundle install --without development test</pre>
- <a href="/v1.3/groups.html">Learn More: Groups</a>
- </div>
- <div class='bullet' id='deployment'>
- <div class='description'>
- Install all dependencies on to a production server.
- Do <b>not</b> use this flag on a development machine.
- </div>
- <pre class="highlight plaintext">$ bundle install --deployment</pre>
- <div class='notes'>
- <p>
- The <code>--deployment</code> flag activates a number of deployment-friendly
- conventions:
- </p>
- <ul>
- <li>Isolate all gems into <code>vendor/bundle</code></li>
- <li>Require an up-to-date <code>Gemfile.lock</code></li>
- <li>
- If <code>bundle package</code> was run, do not fetch gems
- from rubygems.org. Instead, only use gems in the checked
- in <code>vendor/cache</code>
- </li>
- </ul>
- </div>
- <a href="/v1.3/deploying.html">Learn More: Deploying</a>
- </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 class="current" href="/v1.3/">v1.3</a>
- <a href="/v1.5/index.html">v1.5</a>
- <a 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>