Docker.github.io: Docker machine is heavily used in Get Started but it is superseded

[GPPassos]

Problem description

Apparently Docker Machine was superseded, or at least it is under Superseded products and tools in Products Manuals (without any explicit guidance, but see https://github.com/docker/docker.github.io/pull/9239).

However, it is heavily used in the Get Started, suggesting to new users that it is the recommended technology.

Is this intended to be the case or should the get started be changed?

Problem location

It involves the Get Started and the location of Docker Machine in navigation bar on the left .

Suggestions for a fix

1. It should be made explicit whether (and why, or at least some pointer) Docker Machine was superseded (https://github.com/docker/docker.github.io/pull/9239)
2. If so, the Get Started should likely be changed to use the new tool that supersedes docker machine

[ls42]

Is someone able to tell what the replacement for docker-machine is? I'm unable to find the answer in #9239 either.

[ivanistheone]

In case anyone else is wondering, the replacement for docker-machine is to just set DOCKER_HOST env variable to ssh://<user>@<host>. In other words, there is no more need need for docker-machine since docker tooling now support ssh transport as a built-in feature.

Learned via https://github.com/docker/machine/issues/4537

Details:

• If you have ssh login for root on the remote machine set export DOCKER_HOST=ssh://[email protected] (may be considered bad security practices)
• To use a non-root user user set export DOCKER_HOST=ssh://[email protected] after adding user to the docker group using sudo usermod -aG docker user. (tested on Ubuntu 18.04)

[justincormack]

Docker machine is no longer mentioned in the Get Started Guide, which now uses Docker Desktop, so closing this issue. As mentioned above and elsewhere, in general you can provision a machine with Docker easily, just find a machine image with Docker pre installed or use get.docker.com and then use the ssh transport as above.