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. The exact path can usually be found easily from within the application itself (see below), but the standard defaults are listed by the template:

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/

Opening Directory from Bisq

The easiest way to find and open your specific data directory is directly through the Bisq application:

1. Go to the `Account` tab.
2. Select the `Backup` sub-tab.
3. Click the button labeled `OPEN DIRECTORY`.

Clicking the 'OPEN DIRECTORY' button on the Account > Backup screen.

This will open your system's file explorer directly to the Bisq data directory, bypassing the need to manually navigate hidden folders or different paths depending on your OS.

See also

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