Files
docker-machine/docs/install-machine.md
Mary Anthony f8535f1397 Updating with changes dropped in 1830
Tweaking language
Incorporate Olivier's comments
Stomp the nit --- a misspelling
Wrapping lines
Possessive

Signed-off-by: Mary Anthony <mary@docker.com>
2015-09-15 17:00:57 -07:00

2.6 KiB

Install Docker Machine

Docker Machine is supported on Windows, OS X, and Linux operating systems. You can install using one of Docker's automated installation methods or you can download and install via a binary. This page details each of those methods.

OS X and Windows

On OS X and Windows, Machine is installed along with other Docker products when you install the Docker Toolbox. For details on installing Docker Toolbox, see the Mac OS X installation instructions or Windows installation instructions.

If you only want Docker Machine, you can install the Machine binaries directly. Alternatively, OS X users have the option to follow the Linux installation instructions.

On Linux

To install on Linux, do the following:

  1. Install Docker version 1.7.1 or greater:

  2. Download the Machine binary to somewhere in your PATH (for example, /usr/local/bin).

     $ curl -L https://github.com/docker/machine/releases/download/v0.4.0/docker-machine_linux-amd64 > /usr/local/bin/docker-machine
    
  3. Apply executable permissions to the binary:

     $ chmod +x /usr/local/bin/docker-machine
    
  4. Check the installation by displaying the Machine version:

     	$ docker-machine -v
     	machine version 0.4.0
    

Install from binary

The Docker Machine team compiles binaries for several platforms and architectures and makes them available from the Machine release page on Github. To install from a binary:

  1. Download the binary you want.

  2. Rename the binary to docker-machine.

  3. Move the docker-machine file to an appropriate directory on your system.

    For example, on an OS X machine, you might move it to the /usr/local/bin directory.

  4. Ensure the file's executable permissions are correct.

  5. Apply executable permissions to the binary:

     $ chmod +x /usr/local/bin/docker-machine
    
  6. Check the installation by displaying the Machine version:

     $ docker-machine -v
     machine version 0.4.0
    

Where to go next