Introduction

Our Vagrant Docker VM is an full featured VM for running Docker powered environments. It provides an local Apache Reverse Proxy for accessing multiple Docker instances on Port 80 and 443. In addition to that, we offer a range of convenient features such as an integrated Mail Server which is able to catch all outgoing mails, so you never have to worry about accidently sending a mail again. This VM is usable on most popular operating Systems, such as: MacOS, Linux and Windows.

All details and a full list of features can be found inside the Vagrant Docker VM GitHub project.

Requirements

To run our Vagrant Docker VM you need to resolve the following requirements:

One of the following Operating Systems

  • Mac OS
  • Windows
  • Linux

We are currently only able to test our Virtual Machine on those Systems.

One of the following Virtual Machine Providers (VM Software)

  • VirtualBox (Windows + Linux + Mac)
  • VMWare Workstation Pro (Windows + Linux)
  • Prallels (Mac only)
  • VMWare Fusion Pro (Mac only)

This software is required to run your Virtual Machine. Please keep in mind, that VMWare will require you to buy a Vagrant Seat for VMWare to work with Vagrant!

Provisioning Software

  • Vagrant

We use Vagrant to automatically configure the Virtual Machine. Vagrant is essentially free execpt you are using VMWare Fusion ord VMWare Workstation as VM Provider If you use VMWare, you will need to buy a VMWare Seat for the specific Product you own.

Versioning System (optional)

  • Git

Since it is a GitHub hosted project, Git will help you to get Updates on the Vagrant Configuration and allows for an easy Download of the VM.

Quick Start

You may have to Setup your Virtual Machine Provider and Vagrant first! For a Tutorial, head to our Vagrant Setup Guide first!

Select the Quick Start guide for the Operating System you use:

Windows

First we want to open up your Git-Shell and navigate to the directory, where our VM files should be stored.

Then we simply clone the Git Repository.

For this guide, we choose to use C:\VM as project folder, containing our Vagrant Files.

Within the Git-Shell simply fire up the following Command:

We end up with a directory “C:\VM\devvm” which contains our Vagrant Files. We can now navigate in Windows to that directory and configure the VM.

To configure the VM, you can edit two files.

Configurations for your personal informations and preferences we offer, can be done in the File: vm.yml

If you want to tweak the Vagrant settings itself you can also edit the Vagrantfile, which contains the VM Configuration itself.

In Windows, the ssh-key connection of Vagrant seems to be broken. You can however set the setting “useSshPasswordAuth” to true.

When you have VirtualBox and VMWare Workstation installed on the same time, Vagrant may want to provision with VirtualBox first. You can avoid that by deleting the whole section “Provider: VirtualBox” in the Vagrantfile.

Once we have configured our Virtual Machine, we can launch a Powershell (or windows command shell) and start our Vagrant Box.

Mac OS
Linux