Difference between revisions of "Data directory"

From Bisq Wiki
Jump to navigation Jump to search
(create new top-level section for running from command line)
(focus on data directory; add see also section)
Line 1: Line 1:
The '''data directory''' is where all of Bisq's data files are stored, while the '''application directory''' is where Bisq application files are stored.
+
The '''data directory''' is where all of Bisq's data files are stored.
  
 
__TOC__
 
__TOC__
  
= Data Directory Structure =
+
= Data directory structure =
  
 
Notable items in the data directory:
 
Notable items in the data directory:
Line 15: Line 15:
 
** <code>wallet/</code> - BTC and BSQ wallet files and rolling backups, as well as the <code>bisq.spvchain</code> file.
 
** <code>wallet/</code> - BTC and BSQ wallet files and rolling backups, as well as the <code>bisq.spvchain</code> file.
  
= Operating system defaults =
+
= Default locations =
  
== Windows ==
+
=== Windows ===
 
 
=== Data Directory ===
 
  
 
  C:\Users\<username>\AppData\Roaming\Bisq\
 
  C:\Users\<username>\AppData\Roaming\Bisq\
  
=== Application Directory ===
+
=== macOS ===
 
 
C:\Users\<username>\AppData\Local\Bisq\
 
 
 
== macOS ==
 
 
 
=== Data Directory ===
 
  
 
  /Users/<username>/Library/Application Support/Bisq/
 
  /Users/<username>/Library/Application Support/Bisq/
  
=== Application Directory ===
+
=== Linux ===
 
 
/Applications/Bisq.app/Contents/MacOS/
 
 
 
== Linux ==
 
 
 
=== Data Directory ===
 
  
 
  /home/<username>/.local/share/Bisq/
 
  /home/<username>/.local/share/Bisq/
  
=== Application Directory ===
+
= See also =
 
 
/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 [[Command_line_options|notable command-line options]].
 
 
 
== Windows ==
 
 
 
Run <code>Bisq.exe</code> 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 <code>Bisq</code> from the application directory:
 
/Applications/Bisq.app/Contents/MacOS/Bisq [OPTIONS]
 
 
 
== Linux ==
 
  
Run <code>Bisq</code> from the application directory:
+
* [[Switching to a new data directory]]
/opt/Bisq/Bisq [OPTIONS]
+
* [[Running from the command line]]

Revision as of 18:55, 17 June 2020

The data directory is where all of Bisq's data 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

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

macOS

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

Linux

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

See also