basicswap/doc/tor.md

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.

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