New Developers

Getting Started

This page will help you install and configure Vagrant on your local machine for local development.

Configuring

To get up and running right away without having to install the many dependencies needed to get Local Ground to run, you have the option of creating a Virtual Machine with all of the dependencies defined and configured. Follow these steps:

1. Download VirtualBox for your operating system.
2. Download Vagrant for your operating system.
3. At the command line, clone the Git Repository on your local machine: git clone https://github.com/LocalGround/localground.git
4. Navigate to your Local Ground directory, and type vagrant up
5. Wait about 45 minutes for Vagrant to configure your new virtual machine instance (using this shell script).
6. On your client machine (not on the virtual machine), find your server hosts file /etc/hosts for a Mac/Linux OS, and something like C:\Windows\System32\Drivers\etc\hosts for a Windows OS. Open it (with root / admin privileges) and add the following entry to the text file: 127.0.0.1 localground. Save and close.
7. Now, open your web browser to http://localground:7777. Vagrant has been configured to forward all requests to the :7777 port to Apache on your Virtual Server that you just created. You should see a functioning instance of Local Ground operating in your web browser.

Other Useful Information

• To ssh into your machine using Vagrant, just type "vagrant ssh" at the command line in your localground root folder.
• If you ssh to your VM instance, all of the source code is located here: /localground.
• The password for the vagrant user on your VM is also "vagrant"
• If you delete a file in /localground, it will also be deleted on your local machine, as the folder is shared.
• If you edit python files on your local machine, make sure you restart apache in your VM to see the changes take effect:
  • vagrant ssh
  • sudo service apache2 restart