Opened 4 weeks ago

Last modified 9 days ago

#31506 new defect

Write up comprehensive advice to "Tor unexpectedly exited", and link to it from inside Tor Browser

Reported by: arma Owned by: tbb-team
Priority: Medium Milestone:
Component: Applications/Tor Browser Version:
Severity: Normal Keywords:
Cc: ggus Actual Points:
Parent ID: Points:
Reviewer: Sponsor:


We've been getting a steady stream of people who fail to run Tor Browser, who get the "Tor unexpectedly exited" error and they have no ideas what to do.

The internets are full of weird advices about what to do in this situation back in 2014, few of which apply now, so people hunting in google are unlikely to solve this on their own.

I think the advice differs depending on the OS -- on Windows, the first step is about disabling antivirus and firewall; on OS X, the advice is...about finding the old tor process and killing it? Or something else?

We should write up a comprehensive "what the error means, what to do, in what order" explanation, and stick it on so people can find it and so we can point people to it. And then we should link to it from inside Tor Browser, when the thing goes wrong, so there is a canonical place for users to read what they should do.

(And longer term, we should improve the automated handling of this error inside Tor Browser, but that can come later.)

Child Tickets

Change History (3)

comment:1 Changed 4 weeks ago by arma

My first step here, rather than asking the tor browser devs to become tech writers, is to ask the tor browser devs: what should users actually do in these situations? Like, imagine one of us is on Windows and has this problem: what has gone wrong? What should they do?

comment:2 Changed 4 weeks ago by pili

Cc: ggus added
Keywords: docshackathon added

comment:3 Changed 9 days ago by ggus

Keywords: docshackathon removed
Note: See TracTickets for help on using tickets.