Data directory

The data directory is where all of Bisq's data files are stored, while the application directory is where Bisq application files are stored.

Data Directory Structure

Notable items in the data directory:

• bisq.log - main log file with most recent logs, often helpful for debugging. This file may contain private information, so it's usually not wise to post the whole thing publicly.
• bisq.properties - place to store command-line options, so you don't have to specify them every time you run Bisq (where each option is on a new line in <option>=<value> format, e.g., dumpStatistics=true).
• btc_mainnet/ - main data directory.
  • keys/ - keys for signing P2P messages as well as signing and aging payment accounts.
  • db/ - various user data and network data. It is strongly discouraged to edit any files in this directory.
  • tor/ - Tor state data. The hiddenservice/ folder within determines your onion address.
  • wallet/ - BTC and BSQ wallet files and rolling backups, as well as the bisq.spvchain file.

Operating system defaults

Windows

Data Directory

C:\Users\<username>\AppData\Roaming\Bisq\

Application Directory

C:\Users\<username>\AppData\Local\Bisq\

macOS

Data Directory

/Users/<username>/Library/Application Support/Bisq/

Application Directory

/Applications/Bisq.app/Contents/MacOS/

Linux

Data Directory

/home/<username>/.local/share/Bisq/

Application Directory

/opt/Bisq/

Run Bisq from command line

Assuming application directory hasn't been changed from the default listed above, you can run Bisq from the command line with the following commands.

For more on options, see notable command-line options.

Windows

Run Bisq.exe from the application directory:

C:\Users\<username>\AppData\Local\Bisq\Bisq.exe [OPTIONS]

PowerShell tends to work best, particularly if you're passing options.

macOS

Run Bisq from the application directory:

/Applications/Bisq.app/Contents/MacOS/Bisq [OPTIONS]

Linux

Run Bisq from the application directory:

/opt/Bisq/Bisq [OPTIONS]