Document config for HTTPs source credentials

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 f94273af97..c01c0df9f7 100644
--- a/man/gemfile.5.ronn
+++ b/man/gemfile.5.ronn
@@ -33,6 +33,19 @@ be selected for gems that need to use a non-standard repository, suppressing
 this warning, by using the [`:source` option](#SOURCE-source-) or a
 [`source` block](#BLOCK-FORM-OF-SOURCE-GIT-PATH-GROUP-and-PLATFORMS).
 
+### 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