moby/docs/sources/installation/windows.md

page_title: Installation on Windows page_description: Please note this project is currently under heavy development. It should not be used in production. page_keywords: Docker, Docker documentation, Windows, requirements, virtualbox, boot2docker

Windows

Docker can run on Windows using a virtualization platform like VirtualBox. A Linux distribution is run inside a virtual machine and that's where Docker will run.

Installation

Note

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 our blog post, Getting to Docker 1.0

1. Install virtualbox from https://www.virtualbox.org - or follow this tutorial.

2. Download the latest boot2docker.iso from https://github.com/boot2docker/boot2docker/releases.

3. Start VirtualBox.

4. Create a new Virtual machine with the following settings:

    - Name: boot2docker
    - Type: Linux
    - Version: Linux 2.6 (64 bit)
    - Memory size: 1024 MB
    - Hard drive: Do not add a virtual hard drive
   

5. Open the settings of the virtual machine:

   5.1. go to Storage 5.2. click the empty slot below Controller: IDE 5.3. click the disc icon on the right of IDE Secondary Master 5.4. click Choose a virtual CD/DVD disk file

6. Browse to the path where you`ve saved the boot2docker.iso, select the boot2docker.iso and click open.

7. Click OK on the Settings dialog to save the changes and close the window.

8. Start the virtual machine by clicking the green start button.

9. The boot2docker virtual machine should boot now.

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.

Persistent storage

1. Add a virtual hard drive to the VM created in Installation

2. Start the VM

3. Create an empty partition on the attached virtual hard drive

   sudo fdisk /dev/sda
   n (new partition)
   p (primary partition)
   1 (partition 1)
   w (write changes to disk)
   

4. Format the partition using ext4

   mkfs.ext4 -L boot2docker-data /dev/sda1
   

5. Reboot

   sudo reboot
   

6. boot2docker should now auto mount the partition and persist data there. (/var/lib/docker linking to /mnt/sda1/var/lib/docker)

   ls -l /var/lib