From 27ab6ac17bf1f1b7920b49dc9308676cbbf4d7b1 Mon Sep 17 00:00:00 2001
From: thePR0M3TH3AN <53631862+PR0M3TH3AN@users.noreply.github.com>
Date: Sat, 21 Jun 2025 15:15:27 -0400
Subject: [PATCH] docs: add OnionShare crash troubleshooting

---
 docs/troubleshooting.md | 7 +++++++
 1 file changed, 7 insertions(+)

diff --git a/docs/troubleshooting.md b/docs/troubleshooting.md
index 7d8aaba..edc5b26 100644
--- a/docs/troubleshooting.md
+++ b/docs/troubleshooting.md
@@ -14,6 +14,13 @@ This page collects common issues encountered when hosting or accessing flyers.
 - On SELinux-enabled distributions you may see `permission denied` errors when OnionShare writes to the `host` directory.
 - Run `sudo chcon -Rt svirt_sandbox_file_t host` or disable SELinux enforcement for the folder.
 
+## OnionShare crashes
+If the GUI shows "OnionShare exited unexpectedly" check the log file
+`host/<subdomain>/onionshare.log` for details. This usually points to
+network connectivity problems or a missing dependency. Running
+`voxvera serve` from the command line can provide additional error
+output.
+
 If problems persist, consult the OnionShare and Tor documentation for more advanced configuration tips.
 
 ## Electron GUI