Qortal Project

The future of blockchain platforms

User Tools

Site Tools


Qortal Project Wiki

QORT Project Model

Important Notices - MUST READ

QORT Minting

QORT Communications Plugin

QORT Trade Portal

QORT Voting System

QORT Data Hosting

QORT Hardware

Frequently Asked Questions (FAQ)

QORT How-To Guides



For additional support go into the #linux-support channel in Discord.


NOTE: This video references an outdated bootstrap file.

Current bootstrap files can be found at https://www.qortaldb.com

Linux Install from Command Line

From MeadMan: This is the basics of installing the core and UI on Linux from the command line. I use Kubuntu and these instructions work on most Ubuntu derivatives. If you are running some other distro document whatever you do during install and I'll update.

You will need several items installed to make it easier. Java, p7zip & curl.

Install Java 11, p7zip & curl

See if you have it:

  $ java -version
      openjdk version "" 2020-11-04
      OpenJDK Runtime Environment (build
      OpenJDK 64-Bit Server VM (build, mixed mode, sharing)

# If you do skip to "# Install p7zip". If not then do this:

# Ref: https://computingforgeeks.com/how-to-install-java-11-on-ubuntu-debian-linux/

# For Ubuntu 20.04, run:

  sudo apt update
  sudo apt install openjdk-11-jdk

# Install p7zip

  sudo apt install p7zip

# Install curl

  sudo apt install curl

Install Qortal

# Get the files you need for Linux. They currently are:


# You will need to use p7zip to uncompress the DB file. The smaller files unzip with standard utils.

# I'm using "/qortal" as an example. Substitute your path to where you want it.

  md /qortal
  cd /qortal
  cp ~/Downloads/qortal.zip /qortal
  unzip qortal.zip 
  chmod 744 *.sh

# Using "p7zip" because none of the other utils work

  7za  x  ./db.7z

# The perms on the files in the new ./db directory should be 644 and if they aren't set them:

  ls -l /qortal/db
  chmod 644 blockchain.data
  chmod 644 blockchain.properties 
  chmod 644 blockchain.script 

# Edit the settings in the "settings.json" file


# Now start the core

  cd /qortal

# It should tell you it's passed the java version check and give you the PID

  Passed Java version check
  qortal running as pid 2020

# Make sure it is running

  ps -ef | grep -i qort
  root        2020       1 31 13:52 pts/1    00:01:27 java -Djava.net.preferIPv4Stack=false -jar qortal.jar

# It stores the PID (Process ID) in the "run.pid" file:

  cat run.pid

# If you are running IPv4 only you will need this in your settings.json file:


# Omit the comma at the end if it is the last line before the closing brace }

# To stop it gracefully

  cd /qortal

Install Qortal-UI

Right click on the qortal-ui_amd64.deb file and select "Open with QApt Package Installer" If it is missing any libraries have it install them (click "Details" to see which ones)

You should see it running in the right side of your system menu bar. Click on the start icon and type in "qortal", then right click on "qortal ui" and "Add to Desktop" Run it from the desktop

Create Account Seed Phrase (Leave seed phrase hidden or save safely in a Veracrypt file). * If you are going to keep the seed phrase keep it in an encrypted file. Very important *

Account Name: <YourAccountName> Password: <YourPasswordHere>

Current Wallet:

Let it sync and once you can Q-Chat you are sync'd up. Ask for a coin so you can register a name

Set your name in "Name Registration"

Helpful Links & Docs

https://qortal.org/ # Until it is moved into Qortal this is home

http://wiki.qortal.org/doku.php # The Wiki for the Qortal project

https://discord.gg/wVB5TNYrf9 # Once in read the pinned messages for instructions

https://github.com/Qortal/qortal/releases # The Qortal GitHub repo for source code and installation files # See the status of your core # Info about your version etc # All the API calls you never knew about

https://www.youtube.com/channel/UC0U9kb72V7vjnrO5dJltxqQ # Lots of 5-15 minute videos. A very good resource.

Linux Desktop Only Install

From Jaymen:

Linux VPS Only Install

From Jaymen:

Linux Pi4 Only Install

From Jaymen:

linux.txt · Last modified: 2021/08/06 22:38 by gfactor