Skip to content

Running Bisq on Linux using VNC

Source and history

Install Debian 10 Linux with bare minimal packages, then run:


apt-get update
apt-get install -y sudo psmisc tightvncserver awesome autocutsel
wget https://raw.githubusercontent.com/bisq-network/bisq/master/seednode/install_seednode_debian.sh
sed -i -e 's/#BITCOIN_INSTALL=false/BITCOIN_INSTALL=false/' install_seednode_debian.sh
chmod 700 install_seednode_debian.sh
./install_seednode_debian.sh
systemctl disable bisq

Then open /bisq/.vnc/xstartup in a text editor and use this as an example startup script:


#!/bin/bash

xrdb $HOME/.Xresources
xsetroot -solid black
autocutsel -fork

#export GDK_SCALE=2

awesome &

sleep 2

export JAVA_OPTS="-Xms4096M -Xmx4096M"

name=bisqvnc

/bisq/bisq/bisq-desktop \
	--appName=${name} \
	--appDataDir=${name} \
	--maxConnections=16 \
	--useTorForBtc=false \
	--ignoreLocalBtcNode=true \
	--btcNodes=103.99.170.210,103.99.170.220

Next open /etc/systemd/system/vncserver@.service in a text editor and use this as an example:


[Unit]
Description=Start TightVNC server at startup
After=syslog.target network.target

[Service]
Type=forking
User=bisq
Group=bisq
WorkingDirectory=/bisq

PIDFile=/bisq/.vnc/%H:%i.pid
ExecStartPre=-/usr/bin/vncserver -kill :%i > /dev/null 2>&1
ExecStart=/usr/bin/vncserver -localhost -nolisten tcp -depth 16 -geometry 1440x900 :%i
ExecStop=/usr/bin/vncserver -kill :%i
ExecStartPre=/bin/sleep %i

[Install]
WantedBy=multi-user.target

After you have the 2 files in place:


chmod 700 /bisq/.vnc/xstartup
systemctl daemon-reload
systemctl enable vncserver@1
sed -i -e 's/awful.layout.suit.floating/-- awful.layout.suit.floating/' /etc/xdg/awesome/rc.lua
su - bisq
vncpasswd # set a 8 character password for the VNC server

Reboot and Bisq should start within a virtual X session inside a VNC server session. SSH to the server using VNC port forwarding:


ssh user@1.2.3.4 -L 5901:127.0.0.1:5901

Then on your home PC, start a VNC session like this:


vncviewer -depth 16 -encodings tight -compresslevel 9 -quality 4 127.0.0.1:1

Use the 8 character password you set earlier to authenticate, and then you should see Bisq inside X windows over VNC.

Source and history

This article keeps its recovered wording, headings, step order and available images. Formatting and links are adapted for this site. The snapshot does not guarantee that every instruction is current.

Original page
Running Bisq on Linux using VNC
Revision
1898 · 25 Nov 2020
Last recorded editor
Wiz (not a complete author list)
Snapshot
18 October 2026
Source files
Original wikitext · Revision metadata
Recovery gaps
0 restored historical template occurrences · 0 unresolved templates · 0 unresolved article links · 0 unresolved sections

Recovery scope and remaining source gaps