US Ignite fosters the creation of next-generation Internet applications that provide transformative public benefit.

By engaging diverse public and private leaders, we “ignite” the development and deployment of new apps with profound impact on how Americans work, live, learn and play.

Vagrant is recommended installation path, since all the dependencies are installed inside the VM, and is closer to the deployment environment.

The following packages must be installed locally before the VM can be started.

• VirtualBox: https://www.virtualbox.org/wiki/Downloads
• Vagrant: https://www.vagrantup.com/downloads.html

After these packages have been installed, a plugin is required to make sure that the VM has always the latest help packages. This can be installed with:

vagrant plugin install vagrant-vbguest

Once the pre-requisites have been installed the application can be started with the following command:

vagrant up

The application has been preconfigured to use the host-only IP http://22.22.22.12 and forwards the VM port 80 to 8000 so http://localhost:8000 is available as well.

Adding a host alias is recommended. This can be done by adding the following line to /etc/hosts:

22.22.22.12    local-us-ignite.org

Once this is done the application will be available at http://local-us-ignite.org

The VM has been configured to run and reload the code changes automatically without user input. But in case the application server needs to be reloaded it can be done from inside the VM with the following command:

sudo service us_ignite restart

The tests can be triggered from inside the VM by running:

fab test

Generate dummy data (inside the VM):

dj dummy_generate_content

Reset the local db and install fixtures (inside the VM):

dj reset_local_db

Incorporate new objects to the full-text search (inside the VM):

dj buildwatson