Using the DIY Transparency Report Application
The DIY Transparency Report App ("app") is easiest to run in a virtual machine on the end user’s computer. The app can also run on a web server. This guide outlines how to set up the app on the end user’s own computer.
NOTE: As this is alpha software, the installation process is more complicated than polished, full releases. There are several pieces of software that need to be installed before attempting to install the app. Furthermore, the command line is used to start up the application.
The following process has been tested on Macintosh computers running the El Capitan operating system.
Please install (or update to the latest version) these applications and tools in the listed order:
Virtual Box (https://www.virtualbox.org)
Vagrant plugins (install via command line (NOTE: Text in bold denotes a command to run in the end user’s command line utility)):
Hosts updater: vagrant plugin install vagrant-hostsupdater (
VB Guest: vagrant plugin install vagrant-vbguest
On Macs, Ansible is easiest to install using Homebrew (http://brew.sh/)
- Run: brew install ansible
Setuptools for Python: pip install --upgrade setuptools --user python
Optional: Git (https://git-scm.com/book/en/v2/Getting-Started-Installing-Git)
Installing DIY Transparency Report
Once the above requirements are met, follow the below steps in order.
Download the files required to set up the app’s virtual machine using Vagrant as well as the Ansible playbook used for automatically configuring the vagrant machine.
In the terminal, *cd *into the downloaded project’s directory. You can have a look at the VagrantFile and change the virtual machine name or IP address if you wish.
Then, make two directories, "code-api" and "code-frontend".
In the "group_vars" folder, edit “all” on lines 7 and 11 to change the passwords for your database to your own passwords.
Then, run vagrant up.
- You may be asked to enter your administrator password (this is to set up a line in your hosts file so you can access the app at http://diy-transparency.local)
Sit back, and let vagrant and ansible setup the app for you.
Once installation has completed, navigate to http://diy-transparency.local in your browser and start using the app!
NOTE: If you need to pause the virtual machine, run vagrant suspend from the project directory. Simply run vagrant up again to bring the app back online. You’ll have to do the latter after every reboot of the end user’s machine.