Files

T

SvenDowideit 9064f1cd9a Simplify the windows docs and fix formatting

The mention of NAT is confusing for those coming from pre-host-only networking b2d

Docker-DCO-1.1-Signed-off-by: SvenDowideit <SvenDowideit@home.org.au> (github: SvenDowideit)
Upstream-commit: 744d39a46683909b95ac5a769ae5f839a992d59a
Component: engine

2014-06-09 09:10:41 +10:00

2.8 KiB

Raw Blame History

page_title: Installation on Windows page_description: Docker installation on Microsoft Windows page_keywords: Docker, Docker documentation, Windows, requirements, virtualbox, boot2docker

Windows

Docker Engine runs on Windows using a lightweight virtual machine. There is no native Windows Docker client yet, so everything is done inside the virtual machine.

To make this process easier we designed a helper application called Boot2Docker to install the virtual machine and run the Docker daemon.

Demonstration

Installation

Download the latest release of the Docker for Windows Installer
Run the installer, which will install VirtualBox, MSYS-git, the boot2docker Linux ISO and the Boot2Docker management tool.
Run the Boot2Docker Start shell script from your Desktop or Program Files > Docker. The Start script will ask you to enter an ssh key passphrase - the simplest (but least secure) is to just hit [Enter].

The Boot2Docker Start script will connect you to a shell session in the virtual machine. If needed, it will initialize a new VM and start it.

Upgrading

Download the latest release of the Docker for Windows Installer
Run the installer, which will update the Boot2Docker management tool.
To upgrade your existing virtual machine, open a terminal and run:
```
 boot2docker stop
 boot2docker download
 boot2docker start
```

Running Docker

Boot2Docker will log you in automatically so you can start using Docker right away.

Let's try the “hello world” example. Run

$ docker run busybox echo hello world

This will download the small busybox image and print hello world.

Further Details

The Boot2Docker management tool provides some commands:

$ ./boot2docker
Usage: ./boot2docker [<options>] {help|init|up|ssh|save|down|poweroff|reset|restart|config|status|info|delete|download|version} [<args>]

Container port redirection

The latest version of boot2docker sets up a host only network adaptor on which the container's ports will be exposed.

If you run a container with an exposed port:

docker run --rm -i -t -p 80:80 apache

Then you should be able to access that Apache server using the IP address reported to you using:

boot2docker ip

Typically, it is 192.168.59.103, but it can change.

For further information or to report issues, please see the Boot2Docker site

2.8 KiB Raw Blame History