Something does not work. What now?
Open Settings, Troubleshooting. It shows if a source has an error, and it answers the common questions. If that does not help, report a problem.
No new jobs for days
A filter is often too strict. In Settings, Jobs, check Posted within and your keywords. In Where you work, a short time difference or “Hide” for Location not stated also removes many jobs.
Then check Settings, Sources. A source that is off or has an error gives no jobs.
A source shows "Certificate error"
The secure connection to the source failed. A network filter or an old certificate list can cause it. Update Sudo Hire. If it continues, report the problem.
No notifications
Open System Settings, Notifications, Sudo Hire, and allow notifications. Sudo Hire only notifies when new jobs match. It sends no notification after the first scan, and at most one every 2 hours by default.
"Stopped in the background"
The part of the app that reads sources stopped. Choose “Quit Sudo Hire” in the menu bar list, then open the app again. Your jobs and settings are safe.
What do the source errors mean?
Settings, Sources, shows each error in the Status column. Sudo Hire tries again by itself, at the time that the Status column gives, or at the next scan.
| Error | What happened |
|---|---|
| Certificate error | The secure connection failed. If it continues, update the app. |
| No answer | The site did not answer. |
| Read error | Sudo Hire could not read the answer of the site. |
A job is wrong
A job with a wrong country, salary or seniority is a problem in Sudo Hire: report it. A job that is fake or offensive comes from its source: report it to the job board that lists it.
Where is the log?
Sudo Hire writes warnings and errors to a log file, for example a source that could not be read. In Settings, Troubleshooting, choose “Open log folder”. Finder opens the folder of the log.
How do I report a problem?
In Settings, Troubleshooting, choose “Copy diagnostic report”. The button reads “Copied”.
Choose “Report a problem”. A new issue on sudo-hire opens in your browser. You can also open the new issue page (opens in a new tab) from here.
Say what you did and what happened. Paste the report.
The report has the app version, the macOS version, the PHP version and the status of each source. It has no settings, keywords or jobs. It looks like this:
Sudo Hire 1.0.1
macOS 15.1
PHP 8.4.1
Sources
ats: on, last run 2026-11-04T10:05:00+00:00, last success 2026-11-04T10:05:00+00:00, no error
larajobs: on, last run 2026-11-04T10:05:00+00:00, last success 2026-11-04T08:05:00+00:00, error certificateDo not open a public issue for a security problem. Follow SECURITY.md (opens in a new tab) to report it privately.