Jelajahi Sumber

doc: update summary to reflect new location of network-troubleshooting and added Tor onion connections section to net-troubleshooting

darkfi 1 tahun lalu
induk
melakukan
d295fcddac
2 mengubah file dengan 17 tambahan dan 2 penghapusan
  1. 1 1
      doc/src/SUMMARY.md
  2. 16 1
      doc/src/misc/network-troubleshooting.md

+ 1 - 1
doc/src/SUMMARY.md

@@ -18,6 +18,7 @@
 - [DAO](testnet/dao.md)
 - [DarkIRC](misc/darkirc/darkirc.md)
 	- [Private Message](misc/darkirc/private_message.md)
+    - [Network troubleshooting](misc/network-troubleshooting.md)
 
 # Developer Doc
 
@@ -125,5 +126,4 @@
 - [dnetview](misc/dnetview.md)
 - [Zero2darkfi](zero2darkfi/zero2darkfi.md)
   - [darkmap](zero2darkfi/darkmap.md)
-- [Network troubleshooting](misc/network-troubleshooting.md)
 - [Glossary](glossary/glossary.md)

+ 16 - 1
doc/src/misc/network-troubleshooting.md

@@ -103,7 +103,7 @@ cat .local/darkfi/darkirc/hostlist.tsv
 ```
 
 If the list is empty, open `.config/darkfi/darkirc_config` and ensure
-that the `hostlist` field is set with a path of your chosing.
+that the `hostlist` field is set with a path of your choosing.
 
 For example:
 
@@ -138,6 +138,21 @@ connections, please retry the darkirc connection and carefully note the
 connection errors that are happening from peers. See 
 `Error reporting` section to report errors.
 
+### Cannot establish Tor onion connections
+
+You may get an error like this:
+```
+[WARN] darkfi::net::transport::tor: error: tor: Onion Service not found: Failed to obtain hidden service circuit to ????.onion: Unable to download hidden service descriptor
+```
+This happens when arti gets corrupted due to internet downtime or other triggers. To fix this, we'll delete the directory
+
+```
+$ stop tor daemon
+$ rm -rf .local/share/arti
+$ start tor daemon
+$ ./darkirc
+```
+
 ## dnet
 
 dnet is a simple tui to explore darkfi p2p network topology. You can use