Skip to content

Setting up your dev environment

Slin Lee edited this page Dec 20, 2019 · 20 revisions

If you have Vagrant installed (vagrantup.com), you can set up a local environment with this command:

> vagrant up

This will build a VM and install all the prerequisites and set up the local database.

You can edit files normally using their favorite IDE outside the VM, and then run the server with these commands:

> vagrant up
> vagrant ssh
> mvn spring-boot:run

This might vary system by system, but the local webserver is accessible at 127.0.0.1:8080


Troubleshooting tips:

  • vagrant provision will run the setup script again. This is good if for some reason the environment variables aren't set up correctly, etc
  • In more extreme cases, you can start from scratch with vagrant destroy
  • Make sure your VM has enough RAM allocated to it. I think on VirtualBox the default is 1 GB. If you don't increase it, you're likely to see a JAVA OOM error/Heap Space error

The Vagrantfile can be found here if you're interested

Clone this wiki locally