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)
(add note about backing up data directory)
 
(2 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, while the '''application directory''' is where Bisq application files are stored.
+
The '''data directory''' is where all of Bisq's data files are stored.
 +
 
 +
It is crucial that you [[Backing_up_application_data|back up this directory]] regularly.
  
 
__TOC__
 
__TOC__
  
= Data Directory Structure =
+
= Data directory structure =
  
 
Notable items in the data directory:
 
Notable items in the data directory:
Line 15: Line 17:
 
** <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 ==
 
 
 
=== Data Directory ===
 
 
 
C:\Users\<username>\AppData\Roaming\Bisq\
 
 
 
=== Application Directory ===
 
 
 
C:\Users\<username>\AppData\Local\Bisq\
 
 
 
== macOS ==
 
 
 
=== Data Directory ===
 
 
 
/Users/<username>/Library/Application Support/Bisq/
 
 
 
=== Application Directory ===
 
 
 
/Applications/Bisq.app/Contents/MacOS/
 
 
 
== Linux ==
 
 
 
=== Data Directory ===
 
 
 
/home/<username>/.local/share/Bisq/
 
 
 
=== Application Directory ===
 
 
 
/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:
+
{{Default_data_directory_locations}}
/Applications/Bisq.app/Contents/MacOS/Bisq [OPTIONS]
 
  
== Linux ==
+
= See also =
  
Run <code>Bisq</code> from the application directory:
+
* [[Switching to a new data directory]]
/opt/Bisq/Bisq [OPTIONS]
+
* [[Running from the command line]]

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/

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