Socorro is a set of components for collecting, processing and reporting on crashes. It is used by Mozilla for tracking crashes of Firefox, B2G, Thunderbird and other projects. The production Mozilla install is public and hosted at

The components which make up Socorro are:

  • Collector - collects breakpad minidump crashes which come in over HTTP POST
  • Processor - turn breakpad minidump crashes into stack traces and other info
  • Middleware - provide HTTP REST interface for JSON reports and real-time data
  • Web UI aka crash-stats - django-based web app for visualizing crash data

Socorro is available as an RPM for RHEL/CentOS, or you can build from source on Mac OSX, Ubuntu or RHEL/CentOS.

We welcome contributions!

See for up-to-date information about development team activity and our meetings.

This documentation is available on readthedocs. The source and current development activity is available on Github.

The Socorro development mailing list is


This is a very Mozilla-specific product. We do not currently have the capacity to support external users. If you are looking to use Socorro for your product, maybe you want to consider alternatives like electron/mini-breakpad-server.

May 3rd, 2017 Update

For the last year or so, we’ve been removing code and making changes that aren’t backwards compatible. A couple of weeks ago, we (Mozilla) extracted the collector out of Socorro into a separate repository. Because of that, we’re going to start removing code.

If you rely on that collector, the last good release is 270.

You can get it with something like this:

   git clone
   git checkout 270

Or get the tarball::