Qortal Project

The future of blockchain platforms

User Tools

Site Tools


Qortal Project Wiki

Important Notices


Project Model



Trade Portal

Qortal Hosting (QDN)

Voting System

AT System


Frequently Asked Questions (FAQ)

How-To Guides

Node Setup Guides

Third-Party Services


Table of Contents

Qubes OS

Please note: after setting up your computer as a node, be sure to review the Port Forwarding guide to ensure your node functions optimally.

Qortal Core

To install Qortal Core in an App Qube, the prerequisites must be installed in the corresponding Template. To install Qortal Core in a Standalone, the prerequisites must be installed in the same Qube.

Install prerequisites (in Template or Standalone)


sudo apt install openjdk-11-jdk


sudo dnf install java-11-openjdk

Also, if using Fedora + Tor:

sudo dnf install p7zip

Install Qortal Core (in App Qube or Standalone)

wget https://github.com/Qortal/qortal/releases/latest/download/qortal.zip
unzip qortal.zip
rm qortal.zip
cd qortal
chmod +x *.sh

If using Tor (including Whonix):
If the Core is unable to connect to the bootstrap servers, changing Tor circuits may solve the issue. Alternatively, use a web browser to download and extract a bootstrap file, placing the "blockchain.*" files into a folder named "db" within the "qortal" folder from:

Full archive options (5.6 GB):

7za e bootstrap-archive.7z -odb
rm bootstrap-archive.7z

Also, if using Whonix:
Edit the "settings.json" file, and add following line, to allow for "sdwdate":


See here for more info on editing the "settings.json" file.

Run Qortal Core (in App Qube or Standalone)


Qortal UI

To install Qortal UI in an App Qube, either install the deb/rpm package in the corresponding Template, or run the AppImage file from the App Qube. To install Qortal UI in a Standalone, either install the deb/rpm package, or run the AppImage.

Install Qortal UI package (in Template or Standalone)


wget https://github.com/Qortal/qortal-ui/releases/latest/download/Qortal-Setup-amd64.deb
sudo dpkg -i Qortal-Setup-amd64.deb
rm Qortal-Setup-amd64.deb


wget https://github.com/Qortal/qortal-ui/releases/latest/download/Qortal-Setup-amd64.rpm
sudo dnf install Qortal-Setup-amd64.rpm
rm Qortal-Setup-amd64.rpm

or Install Qortal UI AppImage (in App Qube or Standalone)

wget https://github.com/Qortal/qortal-ui/releases/latest/download/Qortal-Setup-amd64.AppImage
chmod +x Qortal-Setup-amd64.AppImage

Run Qortal UI (in App Qube or Standalone)

If using the deb/rpm package:
To run from the Applications Menu:
- First, open Qube Settings, choose the Applications tab, and add Qortal UI.
To run from Terminal:


If using the AppImage:
To run from the Desktop GUI:
- Double click the AppImage file.
To run from Terminal:

qubes_os.txt · Last modified: 05/22/2023 14:06 by quickmythril