From 1c68de798fdebba5eefa1c66a79e946c7bb06fb5 Mon Sep 17 00:00:00 2001 From: Sven Dowideit Date: Wed, 15 Oct 2014 17:24:53 +1000 Subject: [PATCH] Add a little info on how to talk to the TLS encrypted Docker Socket Docker-DCO-1.1-Signed-off-by: Sven Dowideit (github: SvenDowideit) --- docs/sources/articles/https.md | 7 +++++++ docs/sources/reference/api/docker_remote_api.md | 5 ++++- 2 files changed, 11 insertions(+), 1 deletion(-) diff --git a/docs/sources/articles/https.md b/docs/sources/articles/https.md index 2558be1f69..c8873bcbe4 100644 --- a/docs/sources/articles/https.md +++ b/docs/sources/articles/https.md @@ -178,3 +178,10 @@ location using the environment variable `DOCKER_CERT_PATH`. $ export DOCKER_CERT_PATH=${HOME}/.docker/zone1/ $ sudo docker --tlsverify ps + +### Connecting to the Secure Docker port using `curl` + +To use `curl` to make test API requests, you need to use three extra command line +flags: + + $ curl --insecure --cert ~/.docker/cert.pem --key ~/.docker/key.pem https://boot2docker:2376/images/json` diff --git a/docs/sources/reference/api/docker_remote_api.md b/docs/sources/reference/api/docker_remote_api.md index 1475f78256..39c83743bf 100644 --- a/docs/sources/reference/api/docker_remote_api.md +++ b/docs/sources/reference/api/docker_remote_api.md @@ -4,9 +4,12 @@ page_keywords: API, Docker, rcli, REST, documentation # Docker Remote API - - The Remote API is replacing `rcli`. - By default the Docker daemon listens on `unix:///var/run/docker.sock` and the client must have `root` access to interact with the daemon. + - If the Docker daemon is set to use an encrypted TCP socket (`--tls`, + or `--tlsverify`) as with Boot2Docker 1.3.0, then you need to add extra + parameters to `curl` when making test API requests: + `curl --insecure --cert ~/.docker/cert.pem --key ~/.docker/key.pem https://boot2docker:2376/images/json` - If a group named `docker` exists on your system, docker will apply ownership of the socket to the group. - The API tends to be REST, but for some complex commands, like attach