mirror of
https://github.com/PR0M3TH3AN/VoxVera.git
synced 2025-09-08 06:58:42 +00:00
docs: expand Tor installation steps
This commit is contained in:
28
README.md
28
README.md
@@ -90,11 +90,29 @@ Run `voxvera check` to see missing dependencies.
|
|||||||
|
|
||||||
The `voxvera/resources/tor/*` folders only contain small text files named
|
The `voxvera/resources/tor/*` folders only contain small text files named
|
||||||
`placeholder`. VoxVera expects real `tor` and `obfs4proxy` binaries in those
|
`placeholder`. VoxVera expects real `tor` and `obfs4proxy` binaries in those
|
||||||
locations when running `voxvera serve` or the Electron GUI. Install the tools
|
locations when running `voxvera serve` or the Electron GUI.
|
||||||
manually (for example with `apt install tor obfs4proxy`) and set the
|
|
||||||
environment variables `TOR_SOCKS_PORT` and `TOR_CONTROL_PORT` before launching.
|
**Option 1: install via your package manager**
|
||||||
You may also run `scripts/download_tor.sh` to fetch prebuilt binaries and
|
```bash
|
||||||
replace the placeholders.
|
sudo apt update && sudo apt install tor obfs4proxy
|
||||||
|
# or on macOS
|
||||||
|
brew install tor obfs4proxy
|
||||||
|
```
|
||||||
|
Ensure the Tor daemon is running (`sudo service tor start` on Linux).
|
||||||
|
|
||||||
|
**Option 2: use the helper script**
|
||||||
|
```bash
|
||||||
|
scripts/download_tor.sh
|
||||||
|
```
|
||||||
|
The script downloads the official Tor expert bundle for your OS and places the
|
||||||
|
executables under `voxvera/resources/tor/<platform>`.
|
||||||
|
|
||||||
|
After installing either way, set the ports used by Tor:
|
||||||
|
```bash
|
||||||
|
export TOR_SOCKS_PORT=9050
|
||||||
|
export TOR_CONTROL_PORT=9051
|
||||||
|
```
|
||||||
|
Run `voxvera check` to confirm the binaries are detected before launching.
|
||||||
|
|
||||||
---
|
---
|
||||||
|
|
||||||
|
Reference in New Issue
Block a user