Qortal Project

The future of blockchain platforms

User Tools

Site Tools


Qortal Project Wiki

Project Model

Important Notices - MUST READ


Qortal Communications Plugin

The Trade Portal

Voting System

QORT Hosting

QORT Hardware

Frequently Asked Questions (FAQ)

QORT How-To Guides



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


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

# Go to the GitHub repo and 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-1.4.1.zip /qortal
  unzip qortal-1.4.1.zip 
  chmod 744 *.sh

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

  7za  x  ./db-v1.4.1-257440.zip

# 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_1.4.1_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:

  • sudo -i run as root, if you are using root, skip this command * apt-get update update the sytem
  • cd /home go to home directary * adduser test add a new user
  • usermod -a -G sudo test give permisson to the new user * apt-get install openjdk-11-jdk install java dependencies
  • apt-get install unzip install unzip software * apt-get install bc install bc
  • apt-get install p7zip-full install 7zip * cd test go to the new user folder
  • wget https://github.com/Qortal/qortal/releases/download/v1.4.3/qortal-1.4.3.zip download the new core * unzip qortal-1.4.3.zip unzip the core
  • cd qortal
  • wget https://qortal.tmgoxford.com/db.7z download the boostrap * 7za x db.7z unzip boostrap
  • chmod 0777 start.sh make the file executable * chown -R test /home/test/qortal give access permisson of qortal folder to new user
  • su test login as new user * echo -en "{\n\"maxPeers\": 32,\n\"minBlockchainPeers\": 8,\n\"apiDocumentationEnabled\": true\n}\n\"" > settings.json * ./start.sh start the core

Linux Pi4 Only Install

From Jaymen:

linux.txt · Last modified: 2021/03/13 01:07 by gfactor