2014-04-16 00:53:12 +00:00
|
|
|
page_title: Installation on Windows
|
2014-05-26 01:52:57 +00:00
|
|
|
page_description: Docker installation on Microsoft Windows
|
2014-04-16 00:53:12 +00:00
|
|
|
page_keywords: Docker, Docker documentation, Windows, requirements, virtualbox, boot2docker
|
|
|
|
|
|
|
|
|
|
# Windows
|
|
|
|
|
|
2014-04-18 20:21:55 +00:00
|
|
|
> **Note**:
|
2014-04-23 20:48:28 +00:00
|
|
|
> Docker is still under heavy development! We don't recommend using it in
|
|
|
|
|
> production yet, but we're getting closer with each release. Please see
|
2014-04-18 20:21:55 +00:00
|
|
|
> our blog post, [Getting to Docker 1.0](
|
|
|
|
|
> http://blog.docker.io/2013/08/getting-to-docker-1-0/)
|
2014-04-16 00:53:12 +00:00
|
|
|
|
2014-05-26 01:52:57 +00:00
|
|
|
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](https://github.com/boot2docker/boot2docker) to install the
|
|
|
|
|
virtual machine and run the Docker daemon.
|
|
|
|
|
|
2014-04-16 00:53:12 +00:00
|
|
|
|
2014-05-26 01:52:57 +00:00
|
|
|
## Installation
|
2014-04-16 00:53:12 +00:00
|
|
|
|
2014-05-26 01:52:57 +00:00
|
|
|
1. Download the latest release of the [Docker for Windows Installer](https://github.com/boot2docker/windows-installer/releases)
|
|
|
|
|
2. Run the installer, which will install VirtualBox, MSYS-git, the boot2docker Linux ISO and the
|
|
|
|
|
Boot2Docker management tool.
|
|
|
|
|
|
|
|
|
|
3. 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].
|
|
|
|
|
|
2014-04-16 00:53:12 +00:00
|
|
|
|
2014-05-26 01:52:57 +00:00
|
|
|
The `Boot2Docker Start` script will connect you to a shell session in the virtual
|
|
|
|
|
Machine. If needed, it will initialise a new VM and start it.
|
2014-04-16 00:53:12 +00:00
|
|
|
|
2014-05-26 01:52:57 +00:00
|
|
|
## Upgrading
|
2014-04-16 00:53:12 +00:00
|
|
|
|
2014-05-26 01:52:57 +00:00
|
|
|
To upgrade:
|
2014-04-16 00:53:12 +00:00
|
|
|
|
2014-05-26 01:52:57 +00:00
|
|
|
1. Download the latest release of the [Docker for Windows Installer](
|
|
|
|
|
https://github.com/boot2docker/windows-installer/releases)
|
|
|
|
|
2. Run the installer, which will update the Boot2Docker management tool.
|
|
|
|
|
3. To upgrade your existing virtual machine, open a terminal and run:
|
|
|
|
|
|
|
|
|
|
```
|
|
|
|
|
boot2docker stop
|
|
|
|
|
boot2docker download
|
|
|
|
|
boot2docker start
|
|
|
|
|
```
|
2014-04-16 00:53:12 +00:00
|
|
|
|
|
|
|
|
|
|
|
|
|
## Running Docker
|
|
|
|
|
|
2014-05-26 01:52:57 +00:00
|
|
|
Boot2Docker will log you in automatically so you can start using Docker
|
2014-04-16 00:53:12 +00:00
|
|
|
right away.
|
|
|
|
|
|
2014-04-23 20:48:28 +00:00
|
|
|
Let's try the “hello world” example. Run
|
2014-04-16 00:53:12 +00:00
|
|
|
|
2014-05-01 14:13:34 +00:00
|
|
|
$ docker run busybox echo hello world
|
2014-04-16 00:53:12 +00:00
|
|
|
|
|
|
|
|
This will download the small busybox image and print hello world.
|
|
|
|
|
|
2014-05-26 01:52:57 +00:00
|
|
|
# Further Details
|
2014-05-21 08:29:24 +00:00
|
|
|
|
2014-05-26 01:52:57 +00:00
|
|
|
The Boot2Docker management tool provides some commands:
|
2014-05-21 08:29:24 +00:00
|
|
|
|
2014-05-26 01:52:57 +00:00
|
|
|
```
|
|
|
|
|
$ ./boot2docker
|
|
|
|
|
Usage: ./boot2docker [<options>] {help|init|up|ssh|save|down|poweroff|reset|restart|config|status|info|delete|download|version} [<args>]
|
|
|
|
|
```
|
2014-05-21 08:29:24 +00:00
|
|
|
|
|
|
|
|
|
2014-05-26 01:52:57 +00:00
|
|
|
For further information or to report issues, please see the [Boot2Docker site](http://boot2docker.io)
|
