• Install Git https://help.github.com/articles/set-up-git/
• Install VirtualBox https://www.virtualbox.org/wiki/Downloads
• Install Vagrant https://www.vagrantup.com/downloads.html
• git clone https://github.com/levonk/jhipster-devbox.git
• Add Vagrant to your path if it wasn't done for you in Vagrant install
• Go do directory where the above was cloned and do
• vagrant up

This is a Vagrant configuration to set up a complete, virtualized development environment for JHipster users.

The JHipster "development box" is a complete development environment for JHipster users.

It requires to have Vagrant installed on your machine.

It is fully based on Open Source software, most importantly:

• Ubuntu
• Spring Tool Suite
• Chromium Web browser

The "Quick setup" provides a pre-build Virtual Machine, and the "Manual setup" let you build your Virtual Machine yourself. We recommend you use the "Quick setup" if you don't know which option to choose.

Pre-built distributions of this "development box" are available on Atlas.

To install the latest distribution, please run:

On Mac or Linux

vagrant init jhipster/jhipster-devbox; vagrant up --provider virtualbox

On Windows

vagrant init jhipster/jhipster-devbox

vagrant up --provider virtualbox

You can then tune your installation, by following the next sections on customizing and configuring your "development box".

This generates a new "development box" directly from this repository.

• Clone this repository: git clone https://github.com/jhipster/jhipster-devbox.git
• Run vagrant up

This is very important! Modify your system properties, depending on your host's hardware. We recommend, at least:

• 4 CPUs
• 8 Gb of RAM
• 128 Mb of video RAM

Start up the new box:

• Login using the vagrant user (not the 'Ubuntu' user which is selected by default)
  • Password is vagrant, be careful the default keymap is QWERTY!
  • Before logging in, click on the Ubuntu logo to select the Window environment you want to use
    • We recommend you use GNOME Flashback (Metacity), as it doesn't use 3D effects and will be a lot faster on VirtualBox
• Configure your keyboard, if you are not using an English keyboard, once you have logged in:
  • If you chose GNOME Flashback (Metacity):
    • Go to Applications > System Tools > System Settings
    • Select Text Entry
    • Use the + sign to add your keyboard layout
  • If you kept the default Ubuntu desktop:
    • Click the "EN" icon on the top right of your screen
    • Select `Text Entry Settings...``
    • Use the + sign to add your keyboard layout
    • Then select your new keymap by clicking on the "EN" icon again
• Configure your IDE
  • Spring Tool Suite is installed in the /opt/sts-bundle/ directory
• Configure your MySQL database
  • Default password for the root user is vagrant
  • MySQL workbench is installed by default
  • If you want to use MySQL with JHipster, don't forget to edit your application-dev.yml and application-prod.yml files
• Configure you browser
  • Firefox is installed
  • Chromium, which is the Open-Source version of Google Chrome, is also installed
• Other available tools
  • Guake is installed, hit "F12" to have your terminal
  • The Atom text editor is installed
• Generate your application
  • Run yo jhipster and use JHipster normally
• Use the JHipster tools
  • Running mvn will run your JHipster application on port 8080. As this port is forwarded to your host, you can also use http://localhost:8080 on your host machine
  • Running grunt will launch your AngularJS front-end with BrowserSync on port 3000: it is also forwarded to your host, so you can also use http://localhost:3000 on your host machine

• Bootstrap
  • set versions of various files
  • sudo apt-get update
  • sudo apt-get upgrade -y -q
  • set Languages
  • sudo locale-gen
  • sudo dpkg-reconfigure locales
  • etckeeper
    • git-core
    • etckeeper (nodeps)
    • set git-core for etckeeper
    • commit to etckeeper
  • chef
    • chef client
• Via chef
  • Set up repos
    • Java 8
    • Google Chrome
    • AWS
    • Docker
  • Set up google-authenticator
  • Set up NPM & Node
  • Set up Java 8
  • Set up Maven
  • Set up Graphical enviornment
    • Encodings
    • Ubuntu Desktop
    • Virtualbox guest utils
    • Run GUI as non-priviledged user
    • Remove screensaver
    • TODO: don't lock desktop
    • remove unity-lens-shopping
  • set up data tools
    • json2csv
    • xml2json
    • csvkit
    • xmlstarlet
  • set up devops tools
    • set up docker tools
    • set up chef tools
    • set up packer tools
    • set up terraform tools
    • set up CloudFoundry tools
  • Docker prereqs
    • apt-get purge lxc-docker
    • linux-image-extra
    • apparmor
    • docker-engine
    • enable docker
  • user tools
    • bash-completion
    • zsh
    • fish
    • mosh
    • tmux
    • byobu
    • cdargs
    • htop
    • lsof
    • ltrace
    • strace
    • tofrodos
    • ack-grep
    • exuberant-ctags
    • unattended-upgrades
    • pssh
    • clusterssh
    • chromium-browser
    • google-chrome-stable
    • jq
    • Amazon tools
      • ec2-api-toosl
      • ec2-ami-toosl
      • iamcli
      • rdscli
      • moncli
      • ascli
      • elasticache
      • elbcli
  • user directory
    • home directory
    • spring tool suite
    • Jekyll blogging
    • prim .m2
    • proj directory
    • generate ssh key
• via Docker
  • set up Jenkins
  • set up Nexus repo
  • set up Elasticsearch
  • set up Logstash
  • set up Kibana
  • set up dep proxy
  • set up squid proxy
  • set up openvpn server
  • set up postgres
  • set up mongodb
  • set up Apache Titan
  • set up Confluent
    • set up 2 node kafka cluster
    • set up schema registry
    • set up REST Interface
    • set up Kafka Manager
  • set up Spark
    • set up 3 node spark cluster
• cleanup
  • clean up tmp
  • remove apt-get cache
  • write empty bytes
  • rm empty bytes
  • rm empty bytes
  • restart