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.

mkdir -p $COINDATA_PATH/tor
echo 'SocksPort 0.0.0.0:9050' > $COINDATA_PATH/tor/torrc

For a new install

Use the --usetorproxy argument to download the coin binaries over tor, then enable tor with --enabletor. Note that some download links, notably for Litecoin, are unreachable when using tor.

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

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

The --enabletor option will add config to the torrc file, the tor container must afterwards be stopped to load the new config:

docker compose -f docker-compose_with_tor.yml stop

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 --rm swapclient \
    basicswap-prepare --datadir=/coindata --enabletor

docker compose -f docker-compose_with_tor.yml stop

Disable tor on an existing datadir

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

docker compose -f docker-compose_with_tor.yml stop

Update coin release

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