bisq/docs/known-issues-with-installation.md
HenrikJannsen ca061b8009
Extract 3 sections from the release notes as markdown pages.
The release notes page is quite a lot of text and linking to those md files seems a better approach.

Update slightly the text where appropriate.

Signed-off-by: HenrikJannsen <boilingfrog@gmx.com>
2023-07-24 23:43:01 +02:00

2.4 KiB

Known issues with installation

macOS:

We removed notarization from our build pipeline because of the risk of Apple certification revocation ( see https://github.com/bisq-network/bisq/discussions/6341). Unfortunately this will require extra steps when installing Bisq on macOS.

Please follow the guide at https://support.apple.com/en-us/HT202491 in the section If you want to open an app that hasn't been notarized or is from an unidentified developer

If you are running already macOS Ventura (13.0+) you need to do following to be able to start Bisq:

Enter following command in Apple Terminal sudo xattr -rd com.apple.quarantine /Applications/Bisq.app hit enter, and you will be prompted to enter your password to be able to execute the command as super user

Windows:

We removed the developer code signing for the same reason mentioned above. For Windows you just have to ignore the warning after you have verified the installation file yourself and proceed with the installation.

There is a known issue with Anti Virus software. We got several reports from users running into different problems. Either the AV software blocks Bisq or Tor, delete files in the data directory [2] or app directory [1] or cause such a long delay at startup that Tor gets terminated and a file remains locked which can cause that Bisq cannot be started afterwards. To resolve that you need to restart Windows then the lock get released. We are working on solutions to fix those issues.

If you use Crypto currencies on your Windows system be aware that Windows is much more vulnerable to malware than Linux or OSX. Consider to use a dedicated non-Windows system when dealing with cryptocurrencies.

Linux:

Hint for Debian users: If you have problems starting Bisq on Debian use: /opt/bisq/bin/Bisq

If your Linux distro does not support .deb files please follow this instruction:

cd ~/Downloads
mkdir tmp
cd tmp
ar x ../Bisq-64bit-1.9.11.deb
sudo tar Jxvf data.tar.xz
sudo cp -rp opt/Bisq /opt/

That instruction is not tested on many different distros. If you encounter problems please report it in a Github issue so we can improve it.

[1] Application directory (contains application installation files): C:\Users\AppData\Local\Bisq

[2] Data directory (contains all Bisq data including wallet): C:\Users\AppData\Roaming\Bisq\btc_mainnet\tor (you can delete everything except the hiddenservice directory)