SuddenWhipVapor at 13:57, 12 May 2023

2023-05-12T13:57:21Z

SuddenWhipVapor: Created page with "Sometimes you just want to avoid running Bisq on your main PC, having to leave it always on to have your offers visible, you would rather have more free resources to play vide..."

2023-05-12T12:28:46Z

Created page with "Sometimes you just want to avoid running Bisq on your main PC, having to leave it always on to have your offers visible, you would rather have more free resources to play vide..."

New page

Sometimes you just want to avoid running Bisq on your main PC, having to leave it always on to have your offers visible, you would rather have more free resources to play videogames instead, or you just have that home server that's lying there underused while it could also host a bitcoin node AND your Bisq instance; but you also want to control that Bisq instance remotely, while in front of your laptop, and you do not want to install anything more on said laptop but use whatever software you already have. Anything else? I hope not.

This guide will have you follow the steps needed to run Bisq on a headless server (could even be a VPS), running Linux (preferably Debian or one of its derivatives), and accessing it using a web browser as if you were in front of the application itself (tested with Firefox, should work with any other major alternative).

== Requirements ==

As a rule of thumb, at least 1GB of free RAM is needed, as are 2GB of disk space, on an amd64 architecture (no Raspberry Pi will work, nor old 32bit CPUs, while your average 64bit desktop CPU will run just fine).

== Installing xpra ==

As customary, update your system:

<pre>
sudo apt update
sudo apt dist-upgrade
</pre>

For good measure, add xpra repository

<pre>sudo nano /etc/apt/sources.list</pre>

Add the following to bottom of file and then save with '''Ctrl-X''' followed by '''Y'''

<pre>deb https://xpra.org/ bullseye main # edit "bullseye" with your version if needed</pre>

Add xpra GPG key

<pre>wget -q https://xpra.org/gpg.asc -O- | sudo apt-key add -</pre>

Refresh repositories

<pre>sudo apt update</pre>

and install

<pre>sudo apt install xpra</pre>

Verify

<pre>xpra --version</pre>

== Installing Bisq from source ==

We are going to run Bisq on a headless system (no desktop environment) so installing the deb file will most likely not work. Since we are nerds and like to do things the hard way, we will get the source from github, and build the application ourselves.

=== Create Bisq user ===

If you deem it functional, add a user specifically for Bisq

<pre>sudo adduser --gecos "" --disabled-password bisq</pre>

=== Install git and Java ===

We will need the git package to clone Bisq repository, and Java so that Bisq will run

<pre>sudo apt install default-jre default-jdk git</pre>

=== Prepare paths for Bisq ===

Move in a folder where you want the <code>bisq</code> application folder to reside, we will use the <code>bisq</code> user as per the example above, and the custom <code>myapps</code> subfolder of your home (you can place it direcly in home, or wherever you please where the running user has r/w access)

<pre>
sudo su - bisq
mkdir -p myapps
cd myapps
</pre>

=== Install Bisq ===

Clone the latest version repository and compile the source:

<pre>
git clone --branch release/v1.9.10 https://github.com/bisq-network/bisq # change 1.9.10 with current latest version
cd bisq
./gradlew build
</pre>

== Use Bisq remotely ==

Now the fun begins, as you can run bisq through xpra:

<pre>xpra start :100 --bind-tcp=0.0.0.0:9876 --html=on --start=/home/bisq/myapps/bisq/bisq-desktop</pre>

Then, from the browser on your local machine, go to <code>remoteserverip:9876</code>

It will load into a GUI, where you should see your Bisq app barely showing in the bottom right corner; if that happens, click on the "images/windows" icon in the top floating menu, you should see a list of Bisq windows; press the "maximize" icon to show the windows on your screen, and then act accordingly. The same menu action might be needed when popups are shown, as in order to interact with buttons in said popups you sometimes have to manually focus on the popup via the floating menu.

When you have to restart Bisq for any reason (for example to refresh tor files, to resync SPV or DAO state) you have to run, on the remote machine:

<pre>
xpra stop :100 # to stop the running xpra instance
xpra stop :100 # once more, to REALLY stop the running xpra instance (sometimes it won't work with just one call, especially when restarting Bisq)
xpra start :100 --bind-tcp=0.0.0.0:9876 --html=on --start=/home/bisq/myapps/bisq/bisq-desktop # to restart Bisq through xpra
</pre>

This command will make you wait 20s as a timeout to fully close any existing xpra sessions, after which the application will be launched. You should make the above lines into an executable script, so you can just launch that and have it (re)start Bisq:
<pre>
cd /home/bisq
nano bisqxpra
# add the above lines in the file and then save with Ctrl-X and press Y
chmod +x bisqxpra
./bisqxpra #launch Bisq
</pre>

== Tips ==
When you want to restart Bisq, you could just execute the above script, but it would terminate Bisq in a potentially breaking way, so it's best to first log into the web interface, close Bisq using the window close button, and only then start the script.

Want to use a custom data folder, just like you maybe used a custom application folder? Add the relevant parameter to the Bisq command:

<pre>
# make sure you leave the quotes in, to enclose the command to start as a single entity
xpra start :100 --bind-tcp=0.0.0.0:9876 --html=on --start="/home/bisq/myapps/bisq/bisq-desktop --appData=/home/bisq/myapps/bisq-data"
</pre>

Want to add password authentication, so the Bisq instance isn't accessible to just anyone finding its port on the local network?

<pre>
# replace password123 with your password, no need for advanced security as anyone able to access your remote server to see this, will have also access to Bisq anyway
xpra start :100 --bind-tcp=0.0.0.0:9876,auth=password:value=password123 --html=on --start="/home/bisq/myapps/bisq/bisq-desktop --appData=/home/bisq/myapps/bisq-data"
</pre>

← Older revision		Revision as of 13:57, 12 May 2023
Line 1:		Line 1:
−	Sometimes you just want to avoid running Bisq on your main PC, having to leave it always on to have your offers visible, you would rather have more free resources to play videogames instead, or you just have that home server that's lying there underused while it could also host a bitcoin node AND your Bisq instance; but you also want to control that Bisq instance remotely, while in front of your laptop, and you do not want to install anything more on said laptop but use whatever software you already have. Anything else? I hope not.
−
	This guide will have you follow the steps needed to run Bisq on a headless server (could even be a VPS), running Linux (preferably Debian or one of its derivatives), and accessing it using a web browser as if you were in front of the application itself (tested with Firefox, should work with any other major alternative).		This guide will have you follow the steps needed to run Bisq on a headless server (could even be a VPS), running Linux (preferably Debian or one of its derivatives), and accessing it using a web browser as if you were in front of the application itself (tested with Firefox, should work with any other major alternative).

Remote control via web browser using xpra - Revision history

SuddenWhipVapor at 13:57, 12 May 2023

SuddenWhipVapor: Created page with "Sometimes you just want to avoid running Bisq on your main PC, having to leave it always on to have your offers visible, you would rather have more free resources to play vide..."