Enable or Disable Coins

By default, BasicSwap only comes with Particl enabled, but you can easily enable other coins that you want to trade.

This guide will show you how to enable or disable coins on BasicSwap.



Attention

Currently, each coin you add has to be added one by one. Repeat the following step for each coin you want to enable.

Attention

Currently, adding a new coin to BasicSwap requires you to download its blockchain locally. We are working on adding more options, such as using light services and access gateways (i.e., web), which will be available at a later beta stage.

BasicSwap on Docker

If you’ve built BasicSwap using the Docker method, follow these steps to enable or disable coins your instance to the most up-to-date version.

  1. Stop the docker image (this will shut down all BasicSwap processes).

    docker-compose stop
    
  2. If you haven’t set your COINDATA_PATH variable permanently in your .env file, you’ll need to export the variable first.

    export COINDATA_PATH=/var/data/coinswaps
    
  3. Enable coins by typing the following commands accompanied by the coin you want to enable after the –addcoin.

    docker-compose run --rm swapclient basicswap-prepare --datadir=/coindata --addcoin=bitcoin
    

Note

You can copy an existing pruned datadir (excluding bitcoin.conf and any wallets) over to $COINDATA_PATH/bitcoin. Remove any existing wallets after copying over a pruned chain, or the Bitcoin daemon won’t start.

BasicSwap Without Docker

If you’ve built BasicSwap without using the Docker method, follow these steps to add or remove coins to your BasicSwap instance.

Tip

For Linux users, adding or removing coins is simplified through community-developed scripts available here on Github.

  1. Stop BasicSwap completely.

    docker-compose stop
    
  2. Enable coins by typing the following commands accompanied by the coin you want to enable after the –addcoin.

    export SWAP_DATADIR=/Users/$USER/coinswaps
    basicswap-prepare --usebtcfastsync --datadir=/$SWAP_DATADIR --addcoin=bitcoin
    
  3. Activate the change to your BasicSwap instance.

    export SWAP_DATADIR=/Users/$USER/coinswaps
    . $SWAP_DATADIR/venv/bin/activate && python -V
    

Note

You can copy an existing pruned datadir (excluding bitcoin.conf and any wallets) over to $COINDATA_PATH/bitcoin. Remove any existing wallets after copying over a pruned chain, or the Bitcoin daemon won’t start.


See also