Data directory

The data directory is where all of Bisq's application data files (including wallet, account details, trade history, and settings) are stored locally on your computer.

It is crucial that you back up this directory regularly to prevent data loss.

Version Context: The directory structure described below is primarily based on Bisq v1. The location and general purpose remain similar in Bisq 2, although specific file organization within subdirectories like `db/` or `keys/` might differ due to features like multiple identities.

Data directory structure

Notable items typically found within the main Bisq data directory:

• `bisq.log` - The main log file containing recent application activity, often helpful for debugging. Be cautious sharing it publicly as it may contain private information.
• `bisq.properties` - A configuration file where the full list of command-line options can be permanently set (one per line in `<option>=<value>` format, e.g., `dumpStatistics=true`), avoiding the need to specify them each time Bisq is launched.
• `btc_mainnet/` - The primary subdirectory containing most network-specific operational data.
  • `keys/` - Stores cryptographic keys used for signing P2P network messages and for signing and aging payment accounts (in Bisq v1).
  • `db/` - Contains various user data (e.g., closed trades, DAO state) and network data. It is strongly discouraged to manually edit any files in this directory.
  • `tor/` - Holds state data for the built-in Tor connection. The `hiddenservice/` folder within this directory contains the keys determining your Bisq onion address.
  • `wallet/` - Contains your BTC and BSQ wallet files (`bisq_BTC.wallet`, `bisq_BSQ.wallet`), rolling backups, and the SPV chain file (`bisq.spvchain`).

Default locations

The default location of the main Bisq data directory varies by operating system.

Windows

Using PowerShell:

$home\AppData\Roaming\Bisq\

Using cmd:

%USERPROFILE%\AppData\Roaming\Bisq\

macOS

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

This folder could be hidden and not normally accessible on Macs, check the documentation by Apple to see how to be able to work with it.

Linux

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

See also

• Backing up application data
• Restoring application data
• Switching to a new data directory
• Running from the command line