summaryrefslogtreecommitdiff
diff options
context:
space:
mode:
authorHarald Wartig <hwartig@gmail.com>2014-08-03 21:48:10 +0200
committerTim Moore <tmoore@incrementalism.net>2014-10-12 16:09:19 +1100
commita6d05623c9eb3f1b00a6eca12bc01f3f3ac0f4a4 (patch)
tree2f0baf5dbb2f389cc9f2c868f4b9fe4fb168dc4e
parentfe158e6aaaa133d838377687e3a185f9c0825f96 (diff)
downloadbundler-a6d05623c9eb3f1b00a6eca12bc01f3f3ac0f4a4.tar.gz
Document config for HTTPs source credentials
-rw-r--r--man/bundle-config.ronn12
-rw-r--r--man/gemfile.5.ronn13
2 files changed, 25 insertions, 0 deletions
diff --git a/man/bundle-config.ronn b/man/bundle-config.ronn
index d6dfaf505c..f01144edfa 100644
--- a/man/bundle-config.ronn
+++ b/man/bundle-config.ronn
@@ -153,3 +153,15 @@ mirror to fetch gems.
bundle config mirror.http://rubygems.org http://rubygems-mirror.org
+## CREDENTIALS FOR PRIVATE REPOSITORIES
+
+Bundler allows you to configure credentials for private repositories on a per
+source basis.
+
+ bundle config REMOTE_URI USERNAME:PASSWORD
+
+For example to use your company geminabox server you can call:
+
+ bundle config https://gems.example.com/ username:password
+
+This way you can avoid putting secrets into your Gemfile.
diff --git a/man/gemfile.5.ronn b/man/gemfile.5.ronn
index a024da7c3a..df6c12ad02 100644
--- a/man/gemfile.5.ronn
+++ b/man/gemfile.5.ronn
@@ -26,6 +26,19 @@ might contain the gems listed in the `Gemfile`.
Each of these _source_s `MUST` be a valid Rubygems repository. Sources are
checked for gems following the heuristics described in [SOURCE PRIORITY][].
+### PRIVATE REPOSITORIES
+
+To access private repositories you can use `bundle config` to set user and
+password on a per source basis.
+
+ bundle config https://gems.example.com/ user:password
+
+As alternative you can provide credentials directly in the source URI.
+
+ source "https://user:passowrd@gems.example.com"
+
+Credentials provided in the source URI will take presedence.
+
## RUBY (#ruby)
If your application requires a specific Ruby version or engine, specify your