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 application directory and data directory tree)
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, while the '''application directory''' is where Bisq application files are stored.
  
==Default Locations==
+
__TOC__
  
=== Windows ===
+
= Data Directory Structure =
  
Windows 7+
+
Notable items in the data directory:
 +
 
 +
* <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.
 +
 
 +
= Default Locations =
 +
 
 +
== Windows ==
 +
 
 +
=== Data Directory ===
  
 
  C:\Users\<username>\AppData\Roaming\Bisq
 
  C:\Users\<username>\AppData\Roaming\Bisq
  
Windows XP
+
=== Application Directory ===
 +
 
 +
C:\Users\<username>\AppData\Local\Bisq\
 +
 
 +
<br>
 +
Bisq can be run from the command line with <code>C:\Users\<username>\AppData\Local\Bisq\Bisq.exe</code>.
 +
 
 +
PowerShell tends to work best, particularly if you're passing options.
  
C:\Documents and Settings\<username>\Application Data\Bisq
+
== macOS ==
  
=== macOS ===
+
=== Data Directory ===
  
 
  /Users/<username>/Library/Application Support/Bisq
 
  /Users/<username>/Library/Application Support/Bisq
  
=== Linux ===
+
=== Application Directory ===
 +
 
 +
/Applications/Bisq.app/Contents/MacOS/
 +
 
 +
<br>
 +
Bisq can be run from the command line with <code>/Applications/Bisq.app/Contents/MacOS/Bisq</code>.
 +
 
 +
== Linux ==
 +
 
 +
=== Data Directory ===
  
 
  /home/<username>/.local/share/Bisq
 
  /home/<username>/.local/share/Bisq
 +
 +
=== Application Directory ===
 +
 +
/opt/Bisq/Bisq
 +
 +
<br>
 +
Bisq can be run from the command line with <code>/opt/Bisq/Bisq</code>.

Revision as of 21:50, 31 May 2020

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.

Default Locations

Windows

Data Directory

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

Application Directory

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


Bisq can be run from the command line with C:\Users\<username>\AppData\Local\Bisq\Bisq.exe.

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

macOS

Data Directory

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

Application Directory

/Applications/Bisq.app/Contents/MacOS/


Bisq can be run from the command line with /Applications/Bisq.app/Contents/MacOS/Bisq.

Linux

Data Directory

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

Application Directory

/opt/Bisq/Bisq


Bisq can be run from the command line with /opt/Bisq/Bisq.