[tor-commits] [manual/develop] Adding information on how to view Tor logs

[gus@xxxxxxxxxxxxxx]

commit f545adfb19ea395f909d29c6274089b9de5798fd
Author: championquizzer <championquizzer@xxxxxxxxx>
Date:   Wed Feb 3 16:32:32 2021 +0530

    Adding information on how to view Tor logs
---
 content/troubleshooting/contents.lr | 21 +++++++++++++++++++--
 1 file changed, 19 insertions(+), 2 deletions(-)

diff --git a/content/troubleshooting/contents.lr b/content/troubleshooting/contents.lr
index ec70570..40ce060 100644
--- a/content/troubleshooting/contents.lr
+++ b/content/troubleshooting/contents.lr
@@ -18,11 +18,28 @@ You should be able to start browsing the web using Tor Browser shortly after run
 If Tor Browser doesnâ??t connect, there may be a simple solution. Try each of the following:
 
 * Your computerâ??s system clock must be set correctly, or Tor will not be able to connect.
-* Make sure another Tor Browser is not already running. If youâ??re not sure if Tor Browser is running, restart your computer.
+* Make sure another Tor Browser or instance of 'Tor' is not already running on your system. If youâ??re not sure if Tor Browser is running, restart your computer.
 * Make sure that any antivirus program you have installed is not preventing Tor from running. You may need to consult the documentation for your antivirus software if you do not know how to do this.
-* Temporarily disable your firewall.
+* Temporarily disable your firewall.  
+* If Tor Browser was working before and is not working now your system may have been hibernating. A reboot of your system will solve the issue.
 * Delete Tor Browser and install it again. If updating, do not just overwrite your previous Tor Browser files; ensure they are fully deleted beforehand.
 
+### VIEW TOR LOGS
+
+In most cases, taking a look at the Tor logs can be helpful in diagnosing the issue. If youâ??re having trouble connecting, an error message may appear and you can select the option to "copy Tor log to clipboard". Then paste the Tor log into a text file or other document.
+
+If you don't see this option and you have Tor Browser open, you can navigate to the hamburger menu ("â?¡"), then click on "Preferences", and finally on "Tor" in the side bar. At the bottom of the page, next to the "View the Tor logs" text, click the button "View Logs...".
+
+Alternatively, on GNU/Linux, to view the logs right in the terminal, navigate to the Tor Browser directory and launch the Tor Browser from the command line by running:
+
+`./start-tor-browser.desktop --verbose`
+
+or to save the logs to a file (default: tor-browser.log)
+
+`./start-tor-browser.desktop --log [file]` 
+
+More information on this can be found on the [Support Portal](https://support.torproject.org/connecting/connecting-2/).
+
 ### IS YOUR CONNECTION CENSORED?
 
 If you still canâ??t connect, your Internet Service Provider might be censoring connections to the Tor network. Read the [Circumvention](/circumvention) section for possible solutions.



_______________________________________________
tor-commits mailing list
tor-commits@xxxxxxxxxxxxxxxxxxxx
https://lists.torproject.org/cgi-bin/mailman/listinfo/tor-commits