The index and menuing stuff for the cloud docs clearly had some issues during conversion. https://github.com/docker/docker.github.io/tree/master/docker-cloud

I've tried to create a docker-machine on my local ESXi server with the following command:
docker-machine create --driver vmwarevsphere --vmwarevsphere-username=root --vmwarevsphere-password=secret --vmwarevsphere-vcenter=192.168.10.166 vm
All went OK and my log was:
Running pre-create checks... Creating machine... (vm) Copying /Users/michal/.docker/machine/cache/boot2docker.iso to /Users/michal/.docker/machine/machines/vm/boot2docker.iso... (vm) Generating SSH Keypair... (vm) Creating VM... (vm) Uploading Boot2docker ISO ... (vm) Reconfiguring VM... (vm) Waiting for VMware Tools to come online... (vm) Provisioning certs and ssh keys... Waiting for machine to be running, this may take a few minutes... Detecting operating system of created instance... Waiting for SSH to be available... Detecting the provisioner... Provisioning with boot2docker... Copying certs to the local machine directory... Copying certs to the remote machine... Setting Docker configuration on the remote daemon... Checking connection to Docker... Docker is up and running! To see how to connect your Docker Client to the Docker Engine running on this virtual machine, run: docker-machine env vm
However, when I run docker-machine env vm then I get the following error:
Error checking TLS connection: Error checking and/or regenerating the certs: There was an error validating certificates for host "172.17.0.1:2376": dial tcp 172.17.0.1:2376: i/o timeout
and nothing works. On docker-machine ls the state of the machine is Timeout. What is wrong and how can I fix this?

Remark: when I look to config.json and ssh SSHUser@IPAddress then I can login into vm. But I cannot use docker client with it.

URL: engine/installation/mac.md

is there a setup script to deploy Docker for Mac? It would be nice to have a script that Docker is completely setup once it's in the /Applications folder. The goal is to use a application delivery system and have Docker be completely installed.

URL: https://docs.docker.com/docker-cloud/getting-started/link-aws/

URL: https://docs.docker.com/extend/plugin_api/

URL: swarm/configure-tls.md

The page is badly formatted. Looks to be a missing table element.

URL: engine/reference/builder.md

the rendered HTML page on docs.docker.com is broken right after

To use these, simply pass them on the command line using the

URL: engine/getstarted/step_one.md

https://docs.docker.com/userguide/ Page is not found,

per docs here: https://docs.docker.com/ucp/reference/install/

--host-address Specify the visible IP/hostname for this node.

however, passing an actual hostname results in the error below. Hostnames cannot be used, only ipv4 names

FATA[0046] Unsupported host address (ucp.mydomain.com). Please specify an IPv4 address using the '--host-address' flag, and pass the hostname using the '--san' flag.

If you search on Google for "docker for mac volumes", one of the top results is pointing to http://54.71.194.30:4018/userguide/dockervolumes/, which is a broken link.

URL: docker-hub/github.md

The screenshots for automated builds are out of date and don't reflect the current UI

URL: engine/reference/commandline/version.md

The go format becomes empty on HTML sites.

These pages are not being correctly rendered:

• https://docker.github.io/engine/installation/linux/centos/
• https://docker.github.io/engine/installation/linux/fedora/
• https://docker.github.io/engine/getstarted/step_three/
• https://docker.github.io/engine/swarm/swarm-tutorial/create-swarm/
• https://docker.github.io/engine/swarm/swarm-tutorial/add-nodes/
• https://docker.github.io/engine/swarm/swarm-tutorial/deploy-service/
• https://docker.github.io/engine/swarm/swarm-tutorial/inspect-service/
• https://docker.github.io/engine/swarm/swarm-tutorial/scale-service/
• https://docker.github.io/engine/swarm/swarm-tutorial/delete-service/
• https://docker.github.io/engine/swarm/swarm-tutorial/rolling-update/
• https://docker.github.io/engine/swarm/swarm-tutorial/drain-node/
• https://docker.github.io/engine/swarm/services/
• https://docker.github.io/engine/security/certificates/
• https://docker.github.io/docker-for-windows/troubleshoot/
• https://docker.github.io/docker-for-windows/examples/
• https://docker.github.io/docker-for-mac/examples/
• https://docker.github.io/cs-engine/install/
• https://docker.github.io/cs-engine/upgrade/
• https://docker.github.io/cs-engine/release-notes/prior-release-notes/
• https://docker.github.io/ucp/installation/install-production/
• https://docker.github.io/ucp/installation/install-offline/
• https://docker.github.io/ucp/installation/upgrade/
• https://docker.github.io/ucp/installation/uninstall/
• https://docker.github.io/ucp/configuration/use-externally-signed-certs/
• https://docker.github.io/ucp/configuration/dtr-integration/
• https://docker.github.io/ucp/configuration/multi-host-networking/
• https://docker.github.io/ucp/monitor/troubleshoot-ucp/
• https://docker.github.io/docker-trusted-registry/install/
• https://docker.github.io/docker-trusted-registry/install/install-dtr-offline/
• https://docker.github.io/docker-trusted-registry/install/upgrade/upgrade-major/
• https://docker.github.io/docker-trusted-registry/install/upgrade/
• https://docker.github.io/docker-trusted-registry/configure/config-security/
• https://docker.github.io/docker-trusted-registry/repos-and-images/
• https://docker.github.io/docker-cloud/infrastructure/link-aws/
• https://docker.github.io/docker-cloud/infrastructure/cloud-on-aws-faq/
• https://docker.github.io/docker-cloud/installing-cli/
• https://docker.github.io/docker-store/
• https://docker.github.io/toolbox/toolbox_install_mac/
• https://docker.github.io/toolbox/toolbox_install_windows/
• https://docker.github.io/kitematic/userguide/
• https://docker.github.io/registry/configuration/
• https://docker.github.io/registry/spec/manifest-v2-2/
• https://docker.github.io/registry/storage-drivers/s3/
• https://docker.github.io/notary/getting_started/
• https://docker.github.io/notary/reference/server-config/
• https://docker.github.io/notary/changelog/

URL: engine/userguide/networking/work-with-networks.md

"$ docker run -d --name redis_db --network multihost redis

ERROR: Cannot start container bc0b19c089978f7845633027aa3435624ca3d12dd4f4f764b61eac4c0610f32e: container already connected to network multihost

$ docker rm -f redis_db

$ docker network disconnect -f multihost redis_db

$ docker run -d --name redis_db --network multihost redis

7d986da974aeea5e9f7aca7e510bdb216d58682faa83a9040c2f2adc0544795a"

use unknown network multihost

The URL https://docker.github.io/compose/install/ redirects to http://www.fig.sh/install which currently is a 404

The CS Docker engine Ubuntu docs show:

Install additional virtual drivers not in the base image.
$ sudo apt-get install -y linux-image-extra-virtual

There is a chance they will get devicemapper if the virtual package pulls down a newer version of the kernel that is available. This puts the users in a non-supported configuration. It should be:

Install additional virtual drivers not in the base image.
$ sudo apt-get install linux-image-extra-$(uname -r) linux-image-extra-virtual

/ping @mbentley

Incoming Link from Azure Docker on Ubuntu Server compute server.
https://docs.docker.com/sorry/#https://docs.docker.com/articles/https/
Can not find the documentation Running Docker with https to configure Docker to be reachable via the network in a safe manner linked via azure.

URL: https://docs.docker.com/engine/userguide/dockerimages/

See https://docker.github.io/engine/installation/linux/ubuntulinux/.

URL: https://docs.docker.com/docker-trusted-registry/overview/

This URL is referenced here

Fix URL : https://docs.docker.com/docker-trusted-registry/

URL: engine/reference/builder.md

The ARG section is unreadable, needs proper formatting:

https://docs.docker.com/engine/reference/builder/#/arg

Users are reporting a lot of broken links. Looks like all the links under docs.docker.com/reference/ are broken.

Some users have build automation for link-checking and this is affecting them. E.g.
https://travis-ci.org/wsargent/docker-cheat-sheet/builds/165294757#L329

URL: https://docs.docker.com/docker-cloud/getting-started/link-aws/

URL: https://docs.docker.com/engine/installation/ubuntulinux/

The Bootstrap grid needs to add up to 12 at every screen resolution, but it adds up to 14 in medium and larger sizes currently. You can read more about the Bootstrap grid at http://v4-alpha.getbootstrap.com/layout/grid/.

Basically, within a

<div class="row">
  <div class="col-xs-12 col-sm-3 col-md-2 docsidebarnav_section">...</div>
  <div class="col-xs-12 col-sm-9 col-md-10">...</div>
  <div class="hidden-xs hidden-sm col-md-2 tableofcontents_section">...</div>
</div>

URL: engine/userguide/networking/work-with-networks.md

"Let’s try to reach these aliases from container4 (which is connected to both these networks) and container5 (which is connected only to isolated_nw)."
isolated_nw not included container5 now! (docker network disconnect isolated_nw container5)
flip example logic with "local_alias"

URL: engine/reference/commandline/ps.md

Actions are missing from the format parameters of examples on docs.docker.com.
I see $ docker ps --format "table \t" on the website and $ docker ps --format "table {{.ID}}\t{{.Labels}}" when looking the file being rendered by github. inspect.md has the same problem.

URL: engine/reference/run.md

Table tag in ENV section appears to be escaped in the output HTML, which causes the rest of the page to render improperly.

transferred to here from moby/moby#27020

https://docs.docker.com/engine/userguide/storagedriver/device-mapper-driver/#/for-a-direct-lvm-mode-configuration

This doc informs users to push all images to a remote registry and then informs to rm -f /var/lib/docker, thus removing everything including certs that may be stored under this directory tree. For good reasons, we instruct users to change from the default devicemapper loopback configuration that we recommended in early releases, of which they maybe running UCP on those nodes. Deleting the certs in /var/lib/docker/discovery_certs creates a far more complex recovery scenario than just copying the certs back after the lvm changes have been completed. This is the error received when you try to start up the docker daemon after following the doc instructions on a UCP node.

Initializing discovery with TLS
Error starting daemon: discovery initialization failed (Could not read CA certificate \ "/var/lib/docker/discovery_certs/ca.pem" open /var/lib/docker/discovery_certs/ca.pem: no such file or directory

Can additional steps be written into the referenced doc perhaps such as copy the /var/lib/docker directory to /tmp to enable the recovery of items such as certs, etc in order to keep from placing users into extensive recovery scenarios. thnx

URL: engine/admin/logging/splunk.md

My environment is "docker for windows v1.12.1 and VirtualBox on windows 10"; created a node using command "docker-machine create --driver virtualbox node1". Once a node is created, how can the daemon be configured? This is the error I am getting:
docker@node1:~$ dockerd --log-driver=splunk
FATA[0000] Error starting daemon: pid file found, ensure docker is not running or delete /var/run/docker.pid

where is the daemon configuration file that can be configured before restarting the node?

URL: engine/reference/builder.md

something is wrong with the formating after the description for the ARG instruction

URL: engine/getstarted/last_page.md

Several of the links aren't appearing as links; they look like non-working markdown links or similar. Of particular interest is the "more advanced examples" page, which has a broken link section like:

[Learn by example](/engine/tutorials/index.md)</a>

However, trying https://docs.docker.com/engine/tutorials/index.md results in a 404.

URL: engine/reference/builder.md

The format for this page is broken.

URL: engine/reference/commandline/inspect.md
and many more pages with --format examples.

Seems like template examples are missing:

$ docker inspect --format='' $INSTANCE_ID

https://docker.github.io/apidocs/docker-cloud/

These are usually pre-built and the generated HTML artifact is checked in. It looks like we're trying to build the source files rather than just including the path to the pre-built api docs artifact.

URL: engine/reference/commandline/dockerd.md

My environment is "docker for windows v1.12.1" on windows 10 and VirtualBox; created a node with "docker-machine create --driver virtualbox". where do I find daemon configuration file please? Is it not under %programdata%\docker\config\daemon.json

URL: docker-for-windows/troubleshoot.md
There appears to be no documentation on how to lower StartupBytes for MobyLinuxVM below 1024MB. I've altered mine by calling

Set-VMMemory mobylinuxvm -StartupBytes 64MB -DynamicMemoryEnabled $true -MinimumBytes 64MB -MaximumBytes 512MB

but these changes are reverted once I start "docker for windows.exe". I can't find the location where docker for windows stores these settings to adjust them accordingly.

edit: I've figured out that VmMemory in %appdata%\Docker\settings.json configures StartupBytes. This should be documented.

URL: https://docs.docker.com/engine/userguide/dockerimages/

URL: engine/reference/builder.md

Something went wrong at the end of the page. I'm guessing a syntax error is preventing it from rendering it as it should be.

URL: engine/userguide/networking/default_network/configure-dns.md

wrong tags

In the "Learn more" section at the end of the engine/swarm/how-swarm-mode-works/services.md page
it mentions:

• "Read about how swarm mode nodes work."
  with the word "nodes" as a link.
  Unfortunately it links back to the services.md page, not the nodes.md page.

Links from setting up node providers
Link from host site:https://cloud.docker.com/app/btreepress/settings#container-node-providers
Link to dead site:https://docs.docker.com/docker-cloud/getting-started/link-azure/

URL: engine/getstarted/last_page.md

Probably just need to use HTML throughout; the combo of markdown + HTML on one line is not dealt with well in Kramdown

https://docker.github.io/docker-for-mac/
https://docker.github.io/docker-for-windows/
etc

URL: engine/userguide/networking/configure-dns.md

another similar wrong tag

</table>
*Note**

URL: engine/reference/builder.md
I think the bottom of the page is just broken.
Forgotten closing ">" or quote

The tutorial gives an example of starting a container which runs nginx. Since the container runs in the background, we should probably tell the user how to stop it. The other examples before this one are short-lived and exit after the command finishes, or by exiting the shell.