github.com/feiyang21687/docker@v1.5.0/docs/sources/installation/windows.md (about)

     1  page_title: Installation on Windows
     2  page_description: Docker installation on Microsoft Windows
     3  page_keywords: Docker, Docker documentation, Windows, requirements, virtualbox, boot2docker
     4  
     5  # Windows
     6  > **Note:**
     7  > Docker has been tested on Windows 7.1 and 8; it may also run on older versions.
     8  > Your processor needs to support hardware virtualization.
     9  
    10  The Docker Engine uses Linux-specific kernel features, so to run it on Windows
    11  we need to use a lightweight virtual machine (vm).  You use the Windows Docker client to
    12  control the virtualized Docker Engine to build, run, and manage Docker containers.
    13  
    14  To make this process easier, we've designed a helper application called
    15  [Boot2Docker](https://github.com/boot2docker/boot2docker) that installs the
    16  virtual machine and runs the Docker daemon.
    17  
    18  ## Demonstration
    19  
    20  <iframe width="640" height="480" src="//www.youtube.com/embed/oSHN8_uiZd4?rel=0" frameborder="0" allowfullscreen></iframe>
    21  
    22  ## Installation
    23  
    24  1. Download the latest release of the [Docker for Windows Installer](https://github.com/boot2docker/windows-installer/releases/latest)
    25  2. Run the installer, which will install VirtualBox, MSYS-git, the boot2docker Linux ISO,
    26  and the Boot2Docker management tool.
    27     ![](/installation/images/windows-installer.png)
    28  3. Run the `Boot2Docker Start` shell script from your Desktop or Program Files > Boot2Docker for Windows.
    29     The Start script will ask you to enter an ssh key passphrase - the simplest
    30     (but least secure) is to just hit [Enter].
    31  
    32     ![](/installation/images/windows-boot2docker-start.png)
    33  
    34     The `Boot2Docker Start` script will connect you to a shell session in the virtual
    35     machine. If needed, it will initialize a new VM and start it.
    36  
    37  ## Upgrading
    38  
    39  1. Download the latest release of the [Docker for Windows Installer](
    40     https://github.com/boot2docker/windows-installer/releases/latest)
    41  
    42  2. Run the installer, which will update the Boot2Docker management tool.
    43  
    44  3. To upgrade your existing virtual machine, open a terminal and run:
    45  
    46          boot2docker stop
    47          boot2docker download
    48          boot2docker start
    49  
    50  ## Running Docker
    51  
    52  {{ include "no-remote-sudo.md" }}
    53  
    54  Boot2Docker will log you in automatically so you can start using Docker right away.
    55  
    56  Let's try the `hello-world` example image. Run
    57  
    58      $ docker run hello-world
    59  
    60  This should download the very small `hello-world` image and print a `Hello from Docker.` message.
    61  
    62  ## Login with PUTTY instead of using the CMD
    63  
    64  Boot2Docker generates and uses the public/private key pair in your `%HOMEPATH%\.ssh`
    65  directory so to log in you need to use the private key from this same directory.
    66  
    67  The private key needs to be converted into the format PuTTY uses.
    68  
    69  You can do this with
    70  [puttygen](http://www.chiark.greenend.org.uk/~sgtatham/putty/download.html):
    71  
    72  - Open `puttygen.exe` and load ("File"->"Load" menu) the private key from
    73    `%HOMEPATH%\.ssh\id_boot2docker`
    74  - then click: "Save Private Key".
    75  - Then use the saved file to login with PuTTY using `docker@127.0.0.1:2022`.
    76  
    77  # Further Details
    78  
    79  The Boot2Docker management tool provides several commands:
    80  
    81      $ ./boot2docker
    82      Usage: ./boot2docker [<options>] {help|init|up|ssh|save|down|poweroff|reset|restart|config|status|info|ip|delete|download|version} [<args>]
    83  
    84  
    85  ## Container port redirection
    86  
    87  If you are curious, the username for the boot2docker default user is `docker` and the password is `tcuser`.
    88  
    89  The latest version of `boot2docker` sets up a host only network adaptor which provides access to the container's ports.
    90  
    91  If you run a container with an exposed port:
    92  
    93      docker run --rm -i -t -p 80:80 nginx
    94  
    95  Then you should be able to access that nginx server using the IP address reported
    96  to you using:
    97  
    98      boot2docker ip
    99  
   100  Typically, it is 192.168.59.103, but it could get changed by Virtualbox's DHCP
   101  implementation.
   102  
   103  For further information or to report issues, please see the [Boot2Docker site](http://boot2docker.io)