Skip to content
This repository has been archived by the owner on Aug 18, 2020. It is now read-only.

Latest commit

 

History

History
127 lines (90 loc) · 4.6 KB

install-guide.md

File metadata and controls

127 lines (90 loc) · 4.6 KB

Install Guide

Introduction

There are a lot of ways you can run and manipulate Docker Containers, here we provide some documentation on some popular methods.

If you run OSX or Windows and want to run Docker natively, you can't. You must run it in a Virtual Machine. Please skip ahead to Docker Toolbox, for more information on getting started.

Docker Engine

If your running Linux as your local environment or you intend to run in a Docker on a Linux server, you can install it directly.

The requirements will vary from OS to OS, please refer to the Docker install documentation provided by Docker.

Docker also provides a shell script for quick install shell script which you can try. Although it's recommended you review the install information for your system prior to following the Docker Linux Quick Install guide

In general this approach isn't recommended, unless your running Linux locally.

Often it's easier to deal with servers using Docker Machine.

N.B. Docker Engine is included in the Docker Toolbox.

Docker Machine

Docker Machine is a tool that lets you install Docker Engine on virtual hosts, servers and linux machines. It also allows you to manage the hosts with docker-machine commands.

It supports a number of providers (Digital Ocean, AWS, etc) and can be used directly instead of using Vagrant.

Not to say you can't use both Docker Machine and Vagrant together, often it's a good practice as you can get the best of both worlds.

Please refer to the [Docker Machine install documentation][docker-machine-install] for more information.

N.B. Docker Machine is included in the Docker Toolbox.

Docker Toolbox

Docker Toolbox is an installer for quick setup and launch of a Docker environment on Mac and Windows systems.

It also includes:

  • Docker Machine for running docker-machines commands
  • Docker Engine for running the docker commands
  • Docker Compose for running the docker-compose commands
  • Kitematic, the Docker GUI
  • a shell preconfigured for a Docker command-line environment
  • Oracle VirtualBox

N.B. Kitematic can only really be used by single container applications at the moment.

Please follow the Docker Toolbox install guide for your system:

Vagrant

Vagrant provides a number of plugins and tools that make it easy to provision Virtual Machines and servers with Docker and Docker Compose.

Download vagrant and install, no Vagrantfile is provided with this repository, though you can use vagrant with Docker and Docker Machine.

Recommended Plugins:

If you wish to use Docker Machine with Vagrant, you can install Docker Machine using the generic driver.

docker-machine create -d generic \
               --generic-ssh-user vagrant \
               --generic-ssh-key /path/to/.vagrant/machines/machine_name/virtualbox/private_key \
               --generic-ssh-port 22 \
               --generic-ip-address 111.111.111.111 \
               --engine-install-url "https://get.docker.com" \

You'll need to find the ip of the Virtual Machine for the above command to work.

VBoxManage guestproperty enumerate replace_with_machine_name | \
           grep '/VirtualBox/GuestInfo/Net/1/V4/IP' | \
           sed -n 's/^.*value: \([0-9\.]*\),.*$/\1/p')

Reference Material