anchor.diff:  1. `vagrant up` to build the new box
   
   === RAM and CPU Settings
  -If you examine the `vagrantfile` file, you will see that the virtual machine is configured to use 6GB of RAM and
  -2 CPUs.  Feel free to change these values to match your computer's hardware.
  +If you examine the `vagrantfile` file, you will see that the virtual machine is configured to use 6GB of RAM and 2 CPUs.  Feel free to change these values to match your computer's hardware.
   
   === Low Disk Space
  -If an environment is used long enough, it is likely to run out of disk space.  The two main culprits are kernal updates
  -filling up the `/boot` partition and Docker images filling up the `/var/lib/docker` partition.  You have at least 3 options:
  +If an environment is used long enough, it is likely to run out of disk space.  The two main culprits are kernel updates filling up the `/boot` partition and Docker images filling up the `/var/lib/docker` partition.  You have at least 3 options:
   
   * throw away the environment and start fresh
   * clean up the old kernels via `sudo apt-get autoremove`
  
positive.code: toc::[]
  
  == Overview
  This project is a Vagrant box that is provisioned for sofware development.  It is a Linux-based system and
  has many of the tools needed by a developer already installed.  The provisioning mechanism is based on Ansible
  and allows for user-specific customizations to be applied.
  
  == Prerequisites
  
  * [Vagrant](https://www.vagrantup.com/) installed and working
  * [VirtualBox](https://www.virtualbox.org/) installed and working
  * [VirtualBox Extension Pack](https://www.virtualbox.org/wiki/Downloads) installed into VirtualBox
  * **[Virtualization support](https://en.wikipedia.org/wiki/X86_virtualization) enabled in your BIOS**
  * a working internet connection
  * Your corporate VPN running (if you want to apply some work-specific plays)
  
  == Building
  All the components of the environment live in repositories on the internet so there is nothing to build.
  **UPDATE:** some people have experienced issues when rebuilding a box due to flaky networks, online assets
  moving to different locations or installation processes changing.  When you need your box, you need your box
  and you don't have the time to troubleshoot an installation issue.  To combat this problem, we've decided to
  change the build model and bake in much of the software into the base image.  The trade-off we've made to
  ensure quick and stable rebuilds is a larger initial download.  All boxes are currently housed in
  [HashiCorp's Vagrant Cloud](https://app.vagrantup.com/kurron) repository.
  
  == Installation
  Use Git to clone this project, go into the project folder and type `vagrant up` and go get a cup of coffee.  The construction time of the box
  greatly depends on your internet speeds.
  
  ![xubuntu](xubuntu.png)
  
  
negative.code: 1. `echo %USER_PLAYS%` to verify that your new variable has been properly set
  
  === Gather Docker Container Metrics
  `sudo csysdig -pcontainer` will fire up the sysdig tool.  Use `F2` to switch to the container view and see how each container is using system resources.  Explore some http://www.sysdig.org/wiki/sysdig-examples/[examples of how to use Sysdig] and see how can aid in troubleshooting.
  
  === Docker-only Box
  If you don't need a full desktop but just the Docker engine, try using https://github.com/kurron/vagrant-docker-server[vagrant-docker-server]
  
  === Sub-Projects
  **Update:** we've moved away from using `ansible-pull` and to using http://docs.ansible.com/ansible/playbooks_roles.html[Ansible Roles], which give us a better mechanism for reusing provisioning logic.  You can find a https://galaxy.ansible.com/kurron/[list of available roles] in my Ansible Galaxy account.  More are sure to be included over time.
  
  === Installed Software (partial list)
  
  * current http://www.oracle.com/technetwork/java/index.html[JDK]
  * http://sdkman.io/[SDKMAN!] to manage various JVM tools, including Groovy, Kotlin, Scala, Clojure, Java, VisualVM, Vert.x, Grails, Gradle, sbt, Maven, Ant and Leiningen
  * https://nodejs.org/en/[NodeJS] and https://www.npmjs.com/[npm]
  * https://packer.io/[Packer]
  * https://terraform.io/[Terraform]
  * https://aws.amazon.com/cli/[AWS CLI]
  * https://www.docker.com/[Docker]
  * https://www.docker.com/products/docker-compose[Docker Compose]
  * https://www.docker.com/products/docker-machine[Docker Machine]
  * various http://www.jetbrains.com/[JetBrains IDEs]
  * https://github.com/jkbrzt/httpie[httpie] - a more friendly alternative to cURL and wget
  
  === Different Windowing Systems
  *NOTE:* currently a work in incubation.
  
  We have branches that use different window managers that may appeal to you.  Use Git to switch to appropriate branch and run `vagrant up` to try it out.
  
  * Xubuntu
  * Lubuntu
  