Commands for uploading files to Bugsnag via the upload APIs
Clone or download
Latest commit d7882ff Dec 17, 2018


Commands for uploading files to Bugsnag via the Bugsnag Upload APIs

Current Features

  • Uploads dSYM files in bulk
  • Converts bitcode-enabled symbol files stripped of symbol names into full files



Copy bin/bugsnag-dsym-upload into your PATH, or run make install to install to the default directory, /usr/lib/bin.

View usage here or using man bugsnag-dsym-upload


Install via the Homebrew formula:

brew install \

View usage here or using man bugsnag-dsym-upload


Add bugsnag as a plugin in your configuration:

fastlane add_plugin bugsnag

Then add the upload_symbols_to_bugsnag action to your lane:

lane :refresh_dsyms do

Common options:

  • api_key: The API key associated with the project. Informs Bugsnag which project this dSYM should be applied to.
  • dsym_path: A path or array of paths for directories containing *.dSYM files or a single *.zip file to upload. If unspecified, the default behavior is to upload the zip files retrieved by a prior invocation of download_dsyms, or any .dSYM files within the current directory.
  • upload_url: The URL of the server receiving symbol files. Update this value if you are using a private instance of Bugsnag
  • config_file: The path to the project's Info.plist. Set this value if your configuration file is not automatically detected. If set the API key read from this configuration file overrides the api_key option

View usage additional usage information and options by running fastlane action upload_symbols_to_bugsnag.

Check out the example Fastfile to see how to use this plugin. Try it by cloning the repo, running fastlane install_plugins and bundle exec fastlane test.

If you have trouble using plugins, check out the Plugins Troubleshooting guide.