Difference between revisions of "Running from the command line"
Plebeian9000 (talk | contribs) (Created page with "You can '''run Bisq from the command line''' with the following commands. There are several options you can specify—see a rundown here. {{Run_with_...") |
Strayorigin (talk | contribs) (Add sections on Why Run and Persistent Options (properties file); link source for options; add TOC/categories.) |
||
| Line 1: | Line 1: | ||
| − | You can '''run Bisq from the command line''' with the | + | You can '''run Bisq from the command line''' (also known as the terminal or console) to launch the application with specific temporary settings or for debugging purposes. This is done by navigating to the Bisq application directory and executing the program with specific arguments appended. |
| + | |||
| + | There are many options you can specify – [https://github.com/bisq-network/bisq/blob/master/common/src/main/java/bisq/common/config/Config.java#L57 see the source code for a full list]. | ||
| + | |||
| + | __TOC__ | ||
| + | |||
| + | == Why Run from Command Line? == | ||
| + | |||
| + | * '''Temporary Settings:''' Apply a specific command-line option for a single session without permanently changing configuration files (e.g., connecting to a specific Bitcoin node just once). | ||
| + | * '''Troubleshooting:''' Launching from the command line allows you to see log output directly in the terminal window, which can be helpful for diagnosing startup issues or other problems. | ||
| + | * '''Multiple Instances:''' Using options like `--appName` allows running multiple, separate instances of Bisq simultaneously (e.g., for testing or separating identities before Bisq 2's built-in feature). | ||
| + | |||
| + | == How to Run == | ||
| + | |||
| + | The template below shows the typical commands for launching Bisq from the command line on different operating systems. Replace `<nowiki>[OPTIONS]</nowiki>` with any specific command-line options you wish to use for that session. | ||
{{Run_with_command_line_options|<nowiki>[OPTIONS]</nowiki>}} | {{Run_with_command_line_options|<nowiki>[OPTIONS]</nowiki>}} | ||
| + | == Alternative: Persistent Options == | ||
| + | |||
| + | Using command-line arguments applies settings only for the session launched that way. If you want to set options '''persistently''' (so they apply every time you start Bisq normally), it's usually better to edit the `bisq.properties` file located in your [[Data directory]]. | ||
| + | |||
| + | See the [[Data directory]] page for more information on locating this file and its structure. | ||
| + | |||
| + | [[Category:Configuration]] | ||
| + | [[Category:Technical]] | ||
| + | [[Category:Troubleshooting]] | ||
Latest revision as of 00:09, 2 May 2025
You can run Bisq from the command line (also known as the terminal or console) to launch the application with specific temporary settings or for debugging purposes. This is done by navigating to the Bisq application directory and executing the program with specific arguments appended.
There are many options you can specify – see the source code for a full list.
Contents
Why Run from Command Line?
- Temporary Settings: Apply a specific command-line option for a single session without permanently changing configuration files (e.g., connecting to a specific Bitcoin node just once).
- Troubleshooting: Launching from the command line allows you to see log output directly in the terminal window, which can be helpful for diagnosing startup issues or other problems.
- Multiple Instances: Using options like `--appName` allows running multiple, separate instances of Bisq simultaneously (e.g., for testing or separating identities before Bisq 2's built-in feature).
How to Run
The template below shows the typical commands for launching Bisq from the command line on different operating systems. Replace `[OPTIONS]` with any specific command-line options you wish to use for that session.
Windows
Open PowerShell (search the Start menu for PowerShell).
Then from PowerShell, run the following command to switch to your Bisq application directory:
cd $home\AppData\Local\Bisq
Then run the following command to run Bisq:
start Bisq.exe [OPTIONS]
macOS
Open a terminal window by searching for Terminal with Spotlight, and then press Enter.
Then run the following command:
/Applications/Bisq.app/Contents/MacOS/Bisq [OPTIONS]
Linux
In a new terminal window, run the following command:
/opt/bisq/bin/Bisq [OPTIONS]
Alternative: Persistent Options
Using command-line arguments applies settings only for the session launched that way. If you want to set options persistently (so they apply every time you start Bisq normally), it's usually better to edit the `bisq.properties` file located in your Data directory.
See the Data directory page for more information on locating this file and its structure.
