We have a quick-start distribution designed to get you quickly up and running with the OneBusAway application suite. This can be a good way to evaluate OneBusAway without getting bogged down in more complex deployment scenarios.
The OneBusAway application suite is a set of tools to help share real-time public transit information with riders across a variety of interfaces. It includes interfaces for the web, phone, sms, large sign displays, and a REST API that powers a number of mobile applications. For more information on these features, see the application suite documentation.
At a bare minimum, you’ll need Java installed on your system. You will also need the following:
You will need transit data to power your OneBusAway installation. At minimum, you’ll need GTFS static schedule data feed for your target transit agency. Optionally, but ideally, you will also need real-time data for your transit agency. OneBusAway supports real-time data for delays, service alerts, and vehicle positions in the GTFS-realtime format or the SIRI format.
You need to download one of the quickstart bundles. Pick a bundle based on what features you are interested in:
Running OneBusAway is a two-step process:
You can perform these two steps either using our simple GUI configuration tool or from the command-line.
We provide a simple wizard to help you configure and run the OneBusAway quick-start application. Simply double-click the downloaded quick-start war file. Follow the steps and you’ll be up and running in no time.
NOTE: You may need to run the OneBusAway quick-start GUI from the command-line if you want to pass additional options to java, like specifying more memory or server optimization:
java -Xmx1G -server -jar onebusaway-quickstart-assembly.war
First, build your transit data bundle:
java -Xmx1G -server -jar onebusaway-quickstart-assembly.war -build path/to/gtfs.zip path/to/created-transit-bundle
Next, run the webapp:
java -Xmx1G -server -jar onebusaway-quickstart-assembly.war -webapp path/to/created-transit-bundle
Once the webapp has finished startup, browse to http://localhost:8080/.
To see more options for configuring the build and the webapp, including adding real-time information, specify the -help option to get full usage instructions:
java -jar onebusaway-quickstart-assembly.war -help