Difference between revisions of "Running Bisq on Qubes"

From Bisq Wiki
Jump to navigation Jump to search
(implement suggestion in https://github.com/bisq-network/wiki/issues/43)
m (→‎Verify PGP signature: alejandrogarcia83)
 
(2 intermediate revisions by 2 users not shown)
Line 37: Line 37:
  
 
<pre>
 
<pre>
sudo mkdir -p /rw/bind-dirs/opt/Bisq
+
sudo mkdir -p /rw/bind-dirs/opt/bisq
 
sudo mkdir -p /rw/bind-dirs/usr/share/desktop-directories
 
sudo mkdir -p /rw/bind-dirs/usr/share/desktop-directories
 
</pre>
 
</pre>
Line 60: Line 60:
  
 
<pre>
 
<pre>
binds+=( '/opt/Bisq' )
+
binds+=( '/opt/bisq' )
 
binds+=( '/usr/share/desktop-directories' )
 
binds+=( '/usr/share/desktop-directories' )
 
</pre>
 
</pre>
Line 78: Line 78:
 
cd Downloads
 
cd Downloads
  
# Import the signing key of Christoph Atteneder
+
# Import the signing key of Alejandro Garcia (alejandrogarcia83)
curl https://bisq.network/pubkey/29CDFD3B.asc | gpg --import
+
curl https://bisq.network/pubkey/E222AA02.asc | gpg --import
  
 
# Verify the signature of the downloaded binary
 
# Verify the signature of the downloaded binary
Line 97: Line 97:
 
== From dedicated qube ==
 
== From dedicated qube ==
  
Bisq can be started by running <code>/opt/Bisq/Bisq</code> in the <code>bisq-vm</code> qube.
+
Bisq can be started by running <code>/opt/bisq/bin/Bisq</code> in the <code>bisq-vm</code> qube.
  
 
== From dom0 ==
 
== From dom0 ==
Line 105: Line 105:
 
* Q Menu > System Tools > Keyboard > Application Shortcuts
 
* Q Menu > System Tools > Keyboard > Application Shortcuts
 
* Add a shortcut where the command has the format <code>qvm-run -q -a <qube-name> <command></code>
 
* Add a shortcut where the command has the format <code>qvm-run -q -a <qube-name> <command></code>
** For example, in our case: <code>qvm-run -q -a bisq-vm /opt/Bisq/Bisq</code>
+
** For example, in our case: <code>qvm-run -q -a bisq-vm /opt/bisq/bin/Bisq</code>
 
* Assign a system-wide key combination for starting Bisq
 
* Assign a system-wide key combination for starting Bisq
 
** For example <code>Ctrl+Alt+B</code>
 
** For example <code>Ctrl+Alt+B</code>

Latest revision as of 19:16, 25 January 2023

This guide shows how to run Bisq in a dedicated qube in QubesOS. The steps were tested using QubesOS 4.0.3 and a Bisq qube based on the debian-10 template.

How to setup

In dom0

Execute the following steps in dom0.

Create qube

Create a new dedicated qube called bisq-vm based on the debian-10 template.

  • Q Menu > Create Qubes VM > Qube based on a template
  • Template: choose debian-10
  • Check "Launch settings after creation"
  • Press OK

Within a few seconds, the qube is created and the Qube Settings popup opens. Adjust it as follows:

  • Basic > Disk Storage
    • Set "Private Storage max size" to at least 5000 MiB [1]
  • Advanced > Memory / CPU
    • Set "Initial memory" to 6000 MB [2]
    • Set "vCPUs no." to 4
    • Uncheck "Include in memory balancing" [3]
  • Press OK

In dedicated qube

Execute the following steps in the bisq-vm qube.

Create binding dirs

Create the binding dirs needed for the Bisq installation:

sudo mkdir -p /rw/bind-dirs/opt/bisq
sudo mkdir -p /rw/bind-dirs/usr/share/desktop-directories

Restart the qube to apply the binding dir settings.

Configure binding dirs

Setup the binding dirs mapping for the system folders needed for the Bisq installation:

sudo mkdir -p /rw/config/qubes-bind-dirs.d

Specify which system folders are mapped to binding dirs. To do that, create the configuration file:

sudo nano /rw/config/qubes-bind-dirs.d/50_user.conf

and populate it with the following lines [5] :

binds+=( '/opt/bisq' )
binds+=( '/usr/share/desktop-directories' )

Install Bisq

Download Debian package

Go to the Bisq Downloads page and download the Debian package and the corresponding PGP signature.

Verify PGP signature

Check that the downloaded package matches the signature [4]. Assuming the files were downloaded in the Downloads folder:

# Go to the folder where you downloaded the .deb package and the PGP signature
cd Downloads

# Import the signing key of Alejandro Garcia (alejandrogarcia83)
curl https://bisq.network/pubkey/E222AA02.asc | gpg --import

# Verify the signature of the downloaded binary
gpg --digest-algo SHA256 --verify Bisq-*.asc

Install package

sudo dpkg -i Bisq-*.deb

Once this command finishes, Bisq is installed and ready to run.

How to run

From dedicated qube

Bisq can be started by running /opt/bisq/bin/Bisq in the bisq-vm qube.

From dom0

To start Bisq directly from dom0, a keyboard shortcut can be defined:

  • Q Menu > System Tools > Keyboard > Application Shortcuts
  • Add a shortcut where the command has the format qvm-run -q -a <qube-name> <command>
    • For example, in our case: qvm-run -q -a bisq-vm /opt/bisq/bin/Bisq
  • Assign a system-wide key combination for starting Bisq
    • For example Ctrl+Alt+B
  • Press OK

Now pressing the key combination anywhere in QubesOS will automatically start the Bisq application.

Further reading


References

[1] Assuming you only use this Qube for Bisq, this amount of storage will be used for all Bisq files (downloaded installer, installation folder, your local Bisq settings and profile, your Bisq wallet, Bisq logs, etc). Therefore it is important to have enough disk space available, because if Bisq runs out of storage space, this may lead to data corruption and loss of funds. For reference: A fresh Qube containing only a fully sync-ed new installation of Bisq 1.3.6, with no trades / accounts / balances, uses about 1GB of space.

[2] Bisq needs 4 GB, the rest is for other OS processes.

[3] This will ensure that the RAM allocated to this qube is not shared with other Qubes.

[4] For more details, see Verifications section on the Bisq GitHub releases page

[5] The /usr/share/desktop-directories is not really used, but is required during installation. See Issue 848