Quick Start Guide

Welcome to the Raspberry Shake Community! Now it is time to get your Shake up and running!

Click on “Table of Contents” in the left hand side menu to return to the main menu of the manual.

How to assemble your own Raspberry Shake

A Do It Yourself-er? Great! Here is how to assemble your unit for the first time:

Some important notes:


The Raspberry Shake has a plastic enclosure. If you are going to use tools, be careful. You can easily overtighten the screws (especially the leveling feet) and strip the threads. We recommend nothing more than hand-tight.


Be careful not to pinch/ pressure the geophone cables.


The Raspberry Shake board, if left uncovered, will produce some long-period wander. To ensure the highest quality signal, always operate the Raspberry Shake inside of the enclosure provided by OSOP or your own.

Geophone Polarity: If you connect the grey cable from the “+” on the geophone to the “+” on the Raspberry Shake board, the output signal will have the correct polarity.

How to install your Raspberry Shake

Raspberry Shake was designed as a personal seismograph for settings with lots of cultural noise. Feel free to install your Shake in your home, office, under your desk or even in a seismic vault. For best results, install your Raspberry Shake on the bare floor (no carpet) and not on top of your desk. A good location for the Shake would likely be on the concrete slab of the lowest floor, near a foundation wall and away from furnaces, washing machines, air conditioners and such.


The Raspberry Shake has a plastic enclosure. If you are going to use tools, be careful. You can easily overtighten the screws (especially the leveling feet) and strip the threads. We recommend nothing more than hand-tight.

Turning your Raspberry Shake on for the first time


When running your Raspberry Shake for the first time, you must be connected to the Internet to allow the software to automatically update. Depending on your bandwidth, the update could take seconds or minutes. If you purchased your Raspberry Shake on or before November 30th 2016, however, the first update must be done manually. You will find instructions here: Special Case: Upgrade ver.1 never to be seen or heard from again!


For the moment, due to a hardware bug in the Raspberry Pi 3 Model B itself, initial configuration must be done via Ethernet. Later this will be extended to AP mode/ wifi so that things can be done by connecting your smart device directly to Raspberry Shake. Stay tuned.

First time configuration:

  1. Plug an Ethernet cable into your Raspberry Shake and connect it to one of the ports on the back of your Wifi router (do not plug it into your computer).


    We do not recommend using Wifi but it is available. Be aware that using Wifi (as opposed to Ethernet) will introduce RF noise into the Raspberry Shake, often seriously compromising the seismic signal by introducing high amplitude low-frequency spikes.

  2. Once the Ethernet cable is connector to the router, plug the unit in and power it on. A blue LED should light up on the Raspberry Shake card. If you assembled your own unit and a blue LED does not come on, check that the Raspberry Shake card is aligned correctly (see position of Raspberry Shake with respect to the Raspberry Pi header in the video above).

  3. Open a browser on your phone, tablet, desktop computer or laptop and navigate to http://raspberryshake.local:5000

  4. Open the menu, choose the Settings icon and configure your Raspberry Shake. Please take a minute to zoom in and to select exactly where your Raspberry Shake lives, down to the building and not just the city or town. This is critical for accurate earthquake locations. You can update this information at any time. We have been testing this feature by traveling around with Raspberry Shake in our backpacks and reconfiguring it everywhere we go! Please also note that this information will only be used by the automatic earthquake processing system and will not be exposed to the broader community. On the StationView map, for example, we have implemented an algorithm for security that takes your Shake’s location and randomizes it to another location within 1 mile of its actual location.

  5. Hit the “Save and Restart” button.

  6. Optional: Refresh the page after a few minutes, navigate to “Actions” and download Swarm, a Java-based program that will enable you to view the data on your local Desktop computer/ laptop. See How to visualize the waveforms for more details.

Check out EarthquakeView and StationView after data forwarding has been turned on. Search for your Raspberry Shake on the station map (hit Crtl+F5 first to refresh the page!). For more information see The Raspberry Shake Worldwide Seismic Network.


Web elements are currently only activately supported on Google Chrome. Internet Explorer is not supported.