Difference between revisions of "Data directory"

From Bisq Wiki
Jump to navigation Jump to search
(create bare-bones page for data directory locations, to link in spv-resync page)
 
(add note about backing up data directory)
 
(5 intermediate revisions by the same user not shown)
Line 1: Line 1:
The data directory is where ''all'' of Bisq's data files are stored, including [[Bisq wallet]] data.
+
The '''data directory''' is where all of Bisq's data files are stored.
  
==Default Locations==
+
It is crucial that you [[Backing_up_application_data|back up this directory]] regularly.
  
=== Windows ===
+
__TOC__
  
Windows 7+
+
= Data directory structure =
  
C:\Users\<username>\AppData\Roaming\Bisq
+
Notable items in the data directory:
  
Windows XP
+
* <code>bisq.log</code> - 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.
 +
* <code>bisq.properties</code> - place to store [https://github.com/bisq-network/bisq/blob/master/common/src/main/java/bisq/common/config/Config.java#L57 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 <code><option>=<value></code> format, e.g., <code>dumpStatistics=true</code>).
 +
* <code>btc_mainnet/</code> - main data directory.
 +
** <code>keys/</code> - keys for signing P2P messages as well as signing and aging payment accounts.
 +
** <code>db/</code> - various user data and network data. It is strongly discouraged to edit any files in this directory.
 +
** <code>tor/</code> - Tor state data. The <code>hiddenservice/</code> folder within determines your onion address.
 +
** <code>wallet/</code> - BTC and BSQ wallet files and rolling backups, as well as the <code>bisq.spvchain</code> file.
  
C:\Documents and Settings\<username>\Application Data\Bisq
+
= Default locations =
  
=== macOS ===
+
{{Default_data_directory_locations}}
  
/Users/<username>/Library/Application Support/Bisq
+
= See also =
  
=== Linux ===
+
* [[Switching to a new data directory]]
 
+
* [[Running from the command line]]
/home/<username>/.local/share/Bisq
 

Latest revision as of 21:27, 8 April 2021

The data directory is where all of Bisq's data files are stored.

It is crucial that you back up this directory regularly.

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.

Default locations

Windows

Using PowerShell:

$home\AppData\Roaming\Bisq\

Using cmd:

%USERPROFILE%\AppData\Roaming\Bisq\

macOS

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

Linux

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

See also