Wasabi Docs
Getting Started
Why Wasabi
Using Wasabi
Building Wasabi
FAQ
Glossary
Getting Started
Why Wasabi
Using Wasabi
Building Wasabi
FAQ
Glossary
  • Introducing Wasabi

    • Explain Wasabi like I'm 5
  • Installing Wasabi

    • Install-package
  • Using Wasabi

    • Wallet Generation
    • Wallet Load
    • Receive
    • Coinjoin
    • Send
    • Hardware Wallet
    • Bitcoin Full Node
  • Best Practices

    • Password Best Practices
    • Wasabi Backup Best Practices
    • Change Coins
  • Restoring Wasabi

    • Recover a Wallet
    • Restoring Wasabi Wallet in Other Wallets
  • Advanced Installing Wasabi

    • Build from source code
    • Deterministic Build
    • Wasabi Setup in Virtual Machines
  • Advanced Using Wasabi

    • Discreet Mode
    • Testnet
    • PayJoin
    • Headless Wasabi Daemon
    • Starting Wasabi with parameters
    • RPC Interface
    • Supported BIPs

Starting Wasabi with parameters

  • Available commands
    • Config file configurations
    • Non-Config file configurations

Available commands

It is possible to start Wasabi with specific parameters. The parameters override the configurations in the configuration file.

When entering the commands on the command line, they are capital letter insensitive.

The parameters work for both the GUI and the Daemon.

Help about the options is available when using the command line by adding --help to the executable: wassabeed --help or dotnet run -- --help when building from source.

Config file configurations

As of Wasabi version version 2.7.0, each network has their own config file.

All configuration options available via the config files are also available as command line arguments:

Config FileCommand LineEnvironment variable
network file--network=testnetWASABI_NETWORK=testnet
"BackendUri": "https://api.wasabiwallet.io/"--backenduri="https://api.wasabiwallet.io/"WASABI_BACKENDURI="https://api.wasabiwallet.io/"
"CoordinatorUri": ""--coordinatoruri=""WASABI_COORDINATORURI=""
"UseTor": "Enabled"--usetor=enabledWASABI_USETOR=enabled
"TerminateTorOnExit": false--terminatetoronexit=falseWASABI_TERMINATETORONEXIT=false
"TorBridges": "[TorBridge]"--torbridges="[TorBridge]"WASABI_TORBRIDGES="[TorBridge]"
"DownloadNewVersion": true--downloadnewversion=trueWASABI_DOWNLOADNEWVERSION=true
"UseBitcoinRpc": true--usebitcoinrpc=trueWASABI_USEBITCOINRPC=true
"BitcoinRpcCredentialString": "rpcuser:rpcpassword"--bitcoinrpccredentialstring="rpcuser:rpcpassword"WASABI_BITCOINRPCCREDENTIALSTRING="rpcuser:rpcpassword"
"BitcoinRpcEndpoint": "http://127.0.0.1:8333"--bitcoinrpcendpoint="http://127.0.0.1:8333"WASABI_BITCOINRPCENDPOINT="http://127.0.0.1:8333"
"JsonRpcServerEnabled": true--jsonrpcserverenabled=trueWASABI_JSONRPCSERVERENABLED=true
"JsonRpcUser": ""--jsonrpcuser=""WASABI_JSONRPCUSER=""
"JsonRpcPassword": ""--jsonrpcpassword=""WASABI_JSONRPCPASSWORD=""
"JsonRpcServerPrefixes":["http://127.0.0.1:37128/", "http://localhost:37128/"]--jsonrpcserverprefixes=["http://127.0.0.1:37128/", "http://localhost:37128/"]WASABI_JSONRPCSERVERPREFIXES=["http://127.0.0.1:37128/", "http://localhost:37128/"]
"DustThreshold": "0.00005"--dustthreshold=0.00005WASABI_DUSTTHRESHOLD=0.00005
"EnableGpu": true--enablegpu=trueWASABI_ENABLEGPU=true
"CoordinatorIdentifier": "CoinJoinCoordinatorIdentifier"--coordinatoridentifier="coinjoincoordinatoridentifier"WASABI_COORDINATORIDENTIFIER="coinjoincoordinatoridentifier"
"ExchangeRateProvider": "MempoolSpace"--exchangerateprovider=MempoolSpaceWASABI_EXCHANGERATEPROVIDER=MempoolSpace
"FeeRateEstimationProvider": "MempoolSpace"--feerateestimationprovider=MempoolSpaceWASABI_FEERATEESTIMATIONPROVIDER=MempoolSpace
"ExternalTransactionBroadcaster": "MempoolSpace"--externaltransactionbroadcaster=MempoolSpaceWASABI_EXTERNALTRANSACTIONBROADCASTER=MempoolSpace
"MaxCoinJoinMiningFeeRate": 150.0--maxcoinjoinminingfeerate=150.0WASABI_MAXCOINJOINMININGFEERATE=150.0
"AbsoluteMinInputCount": 21--absolutemininputcount=21WASABI_ABSOLUTEMININPUTCOUNT=21
"MaxDaysInMempool": 30--dropunconfirmedtransactionsafterdays=30WASABI_DROPUNCONFIRMEDTRANSACTIONSAFTERDAYS=30

MaxDaysInMempool will only be listed in the config file after being changed from the default (30).

Non-Config file configurations

There are a few special switches that are not present in the Config.json file and are only available using the command line:

SwitchCommand LineEnvironment variable
Ignore P2P transactions--blockonly=trueWASABI_BLOCKONLY=true
The level of detail used during logging--loglevel=traceWASABI_LOGLEVEL=trace
Specify to log only to specific target*--logmodes=consoleWASABI_LOGMODES=console
The path to the directory used during runtime--datadir="$HOME/temp/wasabi-1"WASABI_DATADIR="$HOME/temp/wasabi-1"
Open wallet "WalletName"--wallet=WalletNameWASABI_WALLET=WalletName
Expose the RPC as onion service--rpconionenabled=trueWASABI_RPCONIONENABLED=true
Tor will listen to this SOCKS5 port--torsocksport=35000WASABI_TORSOCKSPORT=35000
Tor will listen to this control port--torcontrolport=35001WASABI_TORCONTROLPORT=35001
Folder to use where Tor binary is located--torfolder="$HOME/tor-browser_en-US/Browser/TorBrowser/Tor"WASABI_TORFOLDER="$HOME/tor-browser_en-US/Browser/TorBrowser/Tor"

*Available options are "" (don't log at all), "file" (log only to file), "console" (log only to console) and "file,console" (log to file and console).

Edit this page
Last Updated: 5/18/26, 7:35 PM
Prev
Headless Wasabi Daemon
Next
RPC Interface