mirror of
https://github.com/PR0M3TH3AN/VoxVera.git
synced 2025-09-08 15:08:42 +00:00
27 lines
1.4 KiB
Markdown
27 lines
1.4 KiB
Markdown
# Troubleshooting
|
|
|
|
This page collects common issues encountered when hosting or accessing flyers.
|
|
|
|
## Tor connectivity
|
|
- 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.
|
|
|
|
## 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.
|
|
|
|
## SELinux
|
|
- 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.
|
|
|
|
If problems persist, consult the OnionShare and Tor documentation for more advanced configuration tips.
|
|
|
|
## Electron GUI
|
|
If `npm start` fails with `spawn voxvera ENOENT`, the `voxvera` command is not in your `PATH`. Install it with `pipx install git+https://github.com/PR0M3TH3AN/VoxVera.git` or run `./install.sh` from the repository.
|
|
|
|
## Missing dependencies
|
|
Run `voxvera check` to see which required tools are present. The command verifies
|
|
`node`, `javascript-obfuscator`, `html-minifier-terser`, `jq`, `qrencode`,
|
|
`onionshare-cli`, and other helpers, then prints a summary of any that are
|
|
missing so you can install them.
|