Skip to content


Folders and files

Last commit message
Last commit date

Latest commit


Repository files navigation

You Are Here

You Are Here web server and repository for spoken stories [This description is FPO].

Support for You Are Here is provided by the Tow Center for Digital Journalism at Columbia University and the Knight Foundation. This code is published under the AGPLv3.

Recommended Hardware

Raspberry Pi 3
8GB MicroSD Card Class 10
2.4A 5V Power Supply
T-Mobile network SIM card
Huawei E303 HSPA+ 3G GSM USB Wireless Mobile Broadband Modem
9db Antenna
WiFi Amplifier
TP-Link Wireless N150 Access Point, 2.4Ghz 150Mbps
Pigtail Cables

How to install

First, be sure to download the latest Jessie or Jessie Lite image from the Raspberry Pi downloads page to install on your SD card. If you download Jessie Lite, you will need to install git before proceeding:

    sudo apt-get install git  

Assuming you are starting with a fresh Raspbian install, these are the steps for installing You Are Here on your Raspberry Pi. It is also assumed that you have one wireless USB adapter and one Huawei E303 3G Modem attached to your RPi's onboard USB ports. The wireless radio must work with the nl80211 driver.

  • Set up your Raspberry Pi with a basic configuration

      sudo raspi-config
  • Clone the repository into your home folder (assuming /home/pi)

      git clone && cd YouAreHere
  • Run the installation script

      sudo ./

The installation process takes about 15 minutes. During installation, you will be prompted to name your wireless access point (default is YouAreHere). After install has completed, you will have a running lighttpd web server, a connection to a 3G data network and will be broadcasting a wireless access point. Connecting to the network and navigating to in a browser window will take you to the root of the web server, currently served from /var/www/.

After the installation script completes, you must SSH into the RPi and do two things: 1/ stop dnsmasq and 2/ manually set the routing gateway to that of the 3G modem (this will be fixed eventually):

    sudo /etc/init.d/dnsmasq stop
    sudo route del default
    sudo route add default gw


  • Recommended to not use a Broadcom WiFi radio, as this is the default radio on the Raspberry Pi 3 and all Broadcom radios are blacklisted by our script blacklist-bc.conf in order to let the external TP Link radio be wlan0.

  • If you update the web site build files, rsync it to the document root in /var/www/ :

      sudo rsync -r www/build/* /var/www/html/
  • Recommended to reboot the device every 24hrs via a cron job if left unattended for long periods of time (to deal with system crashes). To set a cron job rebooting the device once a day, run the following command:

      sudo crontab -e
  • Add to the crontab:

      reboot pi every 24hrs at 5a  
      0 5 * * * reboot -f