Add Tor placeholders instructions and fallback

This commit is contained in:
thePR0M3TH3AN
2025-06-21 19:18:28 -04:00
parent 04e91741f1
commit 148e0d0a36
5 changed files with 95 additions and 5 deletions

View File

@@ -6,6 +6,14 @@ This page collects common issues encountered when hosting or accessing flyers.
- Ensure Tor is allowed through your firewall. On systems using `ufw` you may need to run `sudo ufw allow tor`.
- Some networks block Tor entirely. If you cannot reach onion services, try connecting over a different network or use a Tor bridge.
### Placeholder binaries
The files in `voxvera/resources/tor/*` are not real executables. Install `tor`
and `obfs4proxy` yourself (e.g. `apt install tor obfs4proxy`) then set
`TOR_SOCKS_PORT` and `TOR_CONTROL_PORT` before running `voxvera serve` or the
Electron GUI. Running `scripts/download_tor.sh` can also populate the missing
files automatically.
## Firewall rules
- If `voxvera serve` fails to start OnionShare, verify that outbound connections on ports 9001 and 80 are permitted.
- Corporate or university firewalls can block the hidden service ports required by Tor.