yellowgg2 / electron-crash-report-server Goto Github PK

electron-crash-report-server is a Node.js (hapi) and PostgreSQL (massive) application for collecting crash reports from Electron applications.

During setup change the AUTH_USER and AUTH_PASS environment variables. Once the app has deployed use those values to login.

🐳 electron-crash-report-server is available on Docker Hub. Refer to the docker-compose.yaml file for usage.

If crash reports do not appear after the first deploy restart the app.

Read the development section for information about running in other environments.

const { crashReporter } = require("electron");
crashReporter.start({
	// ...other options
	submitURL: "https://app-name-12345.herokuapp.com/",
});

Refer to the crashReporter documentation for the full details.

Important: Don't forget to start the crashReporter in the main process and each renderer that will create crash reports.

Check out the example electron app and demo server for a working example. The login and password for the demo are crash and electron.

If there are no sample reports use the example (or any other) app to add some reports to the demo server.

electron-crash-report-server can create new issues on GitHub and/or GitLab when it receives a crash report. Using a private repository for these issues is recommended since stack traces and dump files may contain sensitive information about your users or application.

• GitHub demo
• GitLab demo

To get setup you need to add a few environment variables.

Both services require you to set ECRS_URL; note the lack of trailing slash.

ECRS_URL = "https://pacific-falls-32011.herokuapp.com"

GITHUB_OWNER = "user_name"
GITHUB_REPO = "repo_name"
GITHUB_TOKEN = "user_token"

GITLAB_ID = "repo_id"
GITLAB_TOKEN = "user_token"

electron-crash-report-server can send an email when it receives a crash report.

SMTP_LOGIN = "[email protected]"
SMTP_PASSWORD = "password is secret"
SMTP_SERVER = "smtp.mailgun.org"
SMTP_PORT = "587"
SMTP_TO = "[email protected]"
SMTP_FROM = "[email protected]"
SMTP_SUBJECT = "`ecrs: Crash report ${document.id}`"

🚨 SMTP_SUBJECT is evaled at runtime so be careful what you include; a malicious user may be able to craft a crash report that executes code on your server.

Requirements: Node.js LTS 10.x and PostgreSQL 11.x.

git clone https://github.com/johnmuhl/electron-crash-report-server
cd electron-crash-report-server
createdb electron_crash_report_server_development
cp .env.example .env
yarn install
yarn start:dev
# make changes
yarn fmt
yarn test

Use the issue tracker to report bugs or discuss changes and features.

The Unlicense