basicswap/doc/tor.md
tecnovert 0f7df9e5f1
preparescript: Add WALLET_ENCRYPTION_PWD env var.
Removed unnecessary START_DAEMONS env var.
Remove all cached addresses from the basicswap db for a wallet after reseeding.
Check that addresses retreived from the db are owned by teh wallet before they're used/displayed
2022-11-17 00:36:13 +02:00

1.8 KiB

Tor

Basicswap can be configured to route all traffic through a tor proxy.

Note that TOR integration is experimental and should not yet be relied upon.

basicswap-prepare

basicswap-prepare can be configured to download all binaries through tor and to enable or disable tor in all active coin config files.

Create initial files

Docker will create directories instead of files if these don't exist.

mkdir -p $COINDATA_PATH/tor
touch $COINDATA_PATH/tor/torrc

For a new install

Note that some download links, notably for Litecoin, are unreachable when using tor.

If running through docker start the tor container with the following command as the torrc configuration file won't exist yet.

docker compose -f docker-compose_with_tor.yml run --name tor --rm tor \
        tor --allow-missing-torrc --SocksPort 0.0.0.0:9050

docker compose -f docker-compose_with_tor.yml run -e TOR_PROXY_HOST=172.16.238.200 --rm swapclient \
        basicswap-prepare --usetorproxy --datadir=/coindata --withcoins=monero,particl

Start Basicswap with:

docker compose -f docker-compose_with_tor.yml up

Enable tor on an existing datadir

docker compose -f docker-compose_with_tor.yml run -e TOR_PROXY_HOST=172.16.238.200 --rm swapclient \
        basicswap-prepare --datadir=/coindata --enabletor

Disable tor on an existing datadir

docker compose -f docker-compose_with_tor.yml run --rm swapclient \
        basicswap-prepare --datadir=/coindata --disabletor

Update coin release

docker compose -f docker-compose_with_tor.yml up -d tor
docker compose -f docker-compose_with_tor.yml run -e TOR_PROXY_HOST=172.16.238.200 --rm swapclient \
        basicswap-prepare --usetorproxy --datadir=/coindata --preparebinonly --withcoins=bitcoin
docker compose -f docker-compose_with_tor.yml stop