From f4855a7cf00cc96cfffc5cb704b3b2493fe3601e Mon Sep 17 00:00:00 2001 From: Victor Vieux Date: Fri, 27 Sep 2013 16:36:20 +0200 Subject: [PATCH] add .dockercfg doc --- docs/sources/use/workingwithrepository.rst | 27 ++++++++++++++++++++++ 1 file changed, 27 insertions(+) diff --git a/docs/sources/use/workingwithrepository.rst b/docs/sources/use/workingwithrepository.rst index a0d46011e0..66b2928c96 100644 --- a/docs/sources/use/workingwithrepository.rst +++ b/docs/sources/use/workingwithrepository.rst @@ -176,3 +176,30 @@ you can push and pull it like any other repository, but it will **not** be searchable (or indexed at all) in the Central Index, and there will be no user name checking performed. Your registry will function completely independently from the Central Index. + +Authentication file +------------------- + +The authentication is stored in a json file, ``.dockercfg`` located in your +home directory. It supports multiple registry urls. + +``docker login`` will create the "https://index.docker.io/v1/" key. + +``docker login https://my-registry.com`` will create the "https://my-registry.com" key. + +For example: + +.. code-block:: json + + { + "https://index.docker.io/v1/": { + "auth": "xXxXxXxXxXx=", + "email": "email@example.com" + }, + "https://my-registry.com": { + "auth": "XxXxXxXxXxX=", + "email": "email@my-registry.com" + } + } + +The ``auth`` field represents ``base64(:)``