Qortal Project

The future of blockchain platforms

User Tools

Site Tools

Trace:
linux

Differences

This shows you the differences between two versions of the page.

Link to this comparison view

Both sides previous revisionPrevious revision
Next revision		Previous revision
linux [11/21/2021 01:36] – [Linux VPS Only Install] gfactorlinux [01/17/2024 21:07] (current) – crowetic
Line 1: Line 1:
-====== Linux ======+====== Linux (Debian+Ubuntu+Mint) ======
 {{:qortal_official_logo_transparent_.png?400|}} {{:qortal_official_logo_transparent_.png?400|}}
 +=====Installing Qortal on Linux - 2 Methods=====
 +You may also want to check out [[https://qortal.dev]] for simple step-by-step instructions.
 +There is also a video on configuring Ubuntu+Cinnamon Desktop by crowetic on Q-Tube 
 +<code>qortal://APP/Q-Tube/video/crowetic/qtube_vid_ubuntu-22-crowetic-style-qorta_HlLU7O_metadata</code>
 +[[https://qortal.link/APP/Q-Tube/video/crowetic/qtube_vid_ubuntu-22-crowetic-style-qorta_HlLU7O_metadata]]
  
-How to install Qortal on debian linux (ubuntu, mint, debian, etc.) +**Please note:** after setting up your computer as a node, be sure to review the [[Port Forwarding]] guide to ensure your node functions optimally. 
-(Input each command with enter after them.) +
-(any time the terminal asks for a password, it is your OS user password, it won't SHOW the password as you input it, just input it and push enter.) +
-(all commands are run from terminal.) +
-pre-setup, you should update your apt repo -  +
-sudo apt update+
  
-1. Install Java - +=====New Method - Installing Qortal with the assistance of the Qortal UI =====
  
-<code> sudo apt install default-jre </code> +====Step 1- Download the Qortal UI AppImage from qortal.org ==== 
-  +
-and install 'unzip' to extract archives in terminal: +
  
-<code> sudo apt install unzip </code>+====Step 2 - Make the AppImage Executable (either right click it, properties, permissions, allow executing as a program checkbox) ====
  
-2. Download the Qortal Core zip - https://github.com/Qortal/qortal/releases/latest/download/qortal.zip - you can also do this with wget from terminal, like this:+====Step 3 - Run the AppImage file ====
  
-<code> wget https://github.com/Qortal/qortal/releases/latest/download/qortal.zip </code>+===Say YES to installing Java, if your machine doesn't have Java installed, it will download and use a portable Java installation. Say YES to download the Qortal Core. ===
  
-3. Download the Qortal UI debian installer - https://github.com/Qortal/UI/releases/latest/download/qortal-ui_amd64.deb - you can also download this with wget from terminal like this:+That's it, Qortal Core will start, bootstrap, and get synchronized, and you're good to go!
  
-<code> wget https://github.com/Qortal/UI/releases/latest/download/qortal-ui_amd64.deb </code>+===(additional optional visual improvments) ===
  
-4. Extract the Qortal Core zip -  +If you would like to have your Qortal-UI be named Qortal-UI, simply rename the AppImage file to Qortal-UI. (you do not need to keep the .AppImage extension) 
-unzip qortal.zip - if you downloaded with wget, it will be already in your home folder, if you downloaded with the browser, you will first need to move the file to the home folder like this: +
  
-<code> mv Downloads/qortal.zip </code>+If you would like to have the logo attached to the Qortal-UI, right click the file, properties, click the 'blank logo' icon, and browse for the qortal.ico file. It can be found in [[official_images_press_kit|]]
  
-The mv command is only needed if you downloaded with browser, and not with wget.+You may also create 'launchers' so that the Qortal-UI will be in the menu, if you wish to do this, go to your menu editor, and create a new item, call it Qortal UI, then browse to the Qortal-UI AppImage file, attach the logo, and create. That's it!
  
-5. Change to newly created qortal directory, make scripts executable, and start Qortal:  
  
-<code>cd qortal 
-chmod +x *.sh 
-./start.sh </code> 
  
-Qortal will start, you'll see a splash screen telling you it is downloading and extracting the bootstrap for you, then it will run 'in the background' on the taskbar with a Q icon. The icon will be RED when you're not fully synchronized, and BLUE when you are.+=====Old/Manual Method - install Qortal-UI and Qortal Core===== 
 + 
 +How to install Qortal on Linux (ubuntu, mint, debian, debian-based distros.) 
 +(Input each command with enter after them.) 
 +(any time the terminal asks for a password, it is your OS user password, it won't SHOW the password as you input it, just input it and push enter.) 
 +(all commands are run from terminal.) 
 +pre-setup, you should update your apt repo -  
 + 
 +<code>sudo apt update && sudo apt -y upgrade</code> 
 + 
 +1. Install Java, and Unzip-  
 + 
 +<code> sudo apt install default-jre unzip</code> 
 +  
 +2. Download the Qortal Core zip extract, make scripts executable, and run start.sh - https://github.com/Qortal/qortal/releases/latest/download/qortal.zip - you can also do this with wget from terminal, like this (triple-click to select entire code line, copy and paste into terminal and push enter): 
 + 
 +This command will download the zip, extract it, make the scripts executable and start the Qortal Core. You will see it pop up with the splash screen telling you it is downloading and extracting the bootstrap, then it will run on the taskbar. 
 + 
 +<code> wget https://github.com/Qortal/qortal/releases/latest/download/qortal.zip && unzip qortal.zip && cd qortal && chmod +x *.sh && ./start.sh </code>
  
-6. Install Qortal UI - the 'easiest' way is with terminal. If you used wget to download the files, then it will be in your home directory, if not, it will be in your Downloads folder.+3. Download and install the Qortal UI appimage installer - https://github.com/Qortal/qortal-ui/releases/latest/download/Qortal-Setup-amd64.AppImage - you can also download this with wget from terminal like this:
  
-<code> sudo dpkg -i qortal-ui*.deb </code>+<code> cd && cd Desktop && curl -L -O https://github.com/Qortal/qortal-ui/releases/latest/download/Qortal-Setup-amd64.AppImage && mv Qortal-Setup*.AppImage Qortal-UI && chmod +x Qortal-UI </code>
  
-If the file isn't in your home folder and you downloaded with a browser, you can do this instead:+We recommend the AppImage version as it offers auto updates (which can be declined by the user if desired). Qortal will start, you'll see a splash screen telling you it is downloading and extracting the bootstrap for you, then it will run 'in the background' on the taskbar with a Q icon. The icon will be RED when you're not fully synchronized, and BLUE when you are.
  
-<code> sudo dpkg -i Downloads/qortal-ui*.deb </code> 
  
-7. Run the Qortal UI app that is now installed on your system. Run through the account creation process in the Qortal UI, to create your Qortal account. Be sure you use a password you will remember, and save the backup file in multiple locations. This is the only way you can access your account from any other computer, or if your computer fails. Be very sure you have multiple copies of this.+4. Run the Qortal UI app that is now installed on your system. Run through the account creation process in the Qortal UI, to create your Qortal account. Be sure you use a password you will remember, and save the backup file in multiple locations. This is the only way you can access your account from any other computer, or if your computer fails. Be very sure you have multiple copies of this.
  
 Once you have created your account and your node is synchronized, if you would like to become a minter, simply ask in Qortal chat or Q-Chat and let people know where you heard of Qortal. Once you have created your account and your node is synchronized, if you would like to become a minter, simply ask in Qortal chat or Q-Chat and let people know where you heard of Qortal.
  
 **FYI: HELP GUIDES BELOW MAY SUGGEST BOOTSTRAPPING WHICH IS NO LONGER NEEDED AFTER CORE VERSION 2.0! These guides below were made prior to 2.0** **FYI: HELP GUIDES BELOW MAY SUGGEST BOOTSTRAPPING WHICH IS NO LONGER NEEDED AFTER CORE VERSION 2.0! These guides below were made prior to 2.0**
- 
-For additional support go into the #linux-support channel in Discord. 
  
 https://www.youtube.com/watch?v=XO6NoVE79rQ https://www.youtube.com/watch?v=XO6NoVE79rQ
Line 63: Line 71:
 **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.  **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.+You will need several items installed to make it easier. 
  
------------------------------ +First, install Java 11, p7zip & curl
-Install Java 11, p7zip & curl +
----------------+
  
 See if you have it: See if you have it:
Line 76: Line 82:
         OpenJDK 64-Bit Server VM (build 11.0.9.1+1-Ubuntu-0ubuntu1.20.04, mixed mode, sharing)         OpenJDK 64-Bit Server VM (build 11.0.9.1+1-Ubuntu-0ubuntu1.20.04, mixed mode, sharing)
  
-# If you do skip to "# Install p7zip". If not then do this:+If you do skip to: ‘Install p7zip’ section. If not, then do this: https://computingforgeeks.com/how-to-install-java-11-on-ubuntu-debian-linux/
  
-# Ref: https://computingforgeeks.com/how-to-install-java-11-on-ubuntu-debian-linux/+For Ubuntu 20.04, run:
  
-# For Ubuntu 20.04, run:+<code>sudo apt update 
 +sudo apt install openjdk-11-jdk</code>
  
-    sudo apt update +Install p7zip:
-    sudo apt install openjdk-11-jdk+
  
-# Install p7zip +<code>sudo apt install p7zip</code>
-    sudo apt install p7zip+
  
-# Install curl +Install curl:
-    sudo apt install curl+
  
 +<code>sudo apt install curl</code>
  
------------------------------ 
-Install Qortal 
---------------- 
  
-# Get the files you need for Linux. They currently are: +**Install Qortal core:** Get the files you need for Linux. They currently are: 
     https://github.com/Qortal/qortal/releases/latest/download/qortal.zip     https://github.com/Qortal/qortal/releases/latest/download/qortal.zip
-    https://qortal.tmgoxford.com/db.7z 
  
-# You will need to use p7zip to uncompress the DB file. The smaller files unzip with standard utils.+Now start the core:
  
-# We’re using "/qortal" as an example here. Substitute your path to where you want it. +<code>cd /qortal 
-    md /qortal +./start.sh</code>
-    cd /qortal +
-    cp ~/Downloads/qortal.zip /qortal +
-    unzip qortal.zip  +
-    chmod 744 *.sh+
  
-# Using "p7zip" because none of the other utils work +It should tell you it's passed the java version check and give you the PID: 
-    7za  x  ./db.7z+     
 +    "Passed Java version check 
 +    qortal running as pid 2020"
  
-# The perms on the files in the new ./db directory should be 644 and if they aren't set them: +Make sure it is running:
-    ls -l /qortal/db +
-    chmod 644 blockchain.data +
-    chmod 644 blockchain.properties  +
-    chmod 644 blockchain.script +
  
-# Edit the settings in the "settings.json" file +<code>ps -ef | grep -i qort 
-    { +    root        2020       1 31 13:52 pts/1    00:01:27 java -Djava.net.preferIPv4Stack=false -jar qortal.jar</code>
-    "maxPeers":32, +
-    "minOutboundPeers":16, +
-    "minBlockchainPeers":8, +
-    "maxNetworkThreadPoolSize":25, +
-    "apiDocumentationEnabled":true +
-    }+
  
-# Now start the core +It stores the PID (Process ID) in the "run.pid" file: 
-    cd /qortal +    
-    ./start.sh  +
- +
-# 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     cat run.pid
     2020     2020
          
-# If you are running IPv4 only you will need this in your settings.json file: +To stop it gracefully:
-    "bindAddress":"0.0.0.0",  +
-# Omit the comma at the end if it is the last line before the closing brace }+
  
-# To stop it gracefully  +<code>cd /qortal 
-    cd /qortal +./stop.sh</code>
-    ./stop.sh+
  
  
---------------------------- +**Install Qortal-UI:** Right click on the qortal-ui_amd64.deb file and select "Open with QApt Package Installer"
-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) If it is missing any libraries have it install them (click "Details" to see which ones)
Line 166: Line 137:
  
 Create Account Seed Phrase (Leave seed phrase hidden or save safely in a Veracrypt file). 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!** **If you are going to keep the seed phrase keep it in an encrypted file. Very important!**
  
Line 173: Line 145:
 Current Wallet:  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+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" Set your name in "Name Registration"
- 
 ===== Helpful Links & Docs ===== ===== Helpful Links & Docs =====
  
Line 199: Line 170:
  
 **From Jaymen:**  **From Jaymen:** 
-<code>apt-get update    +<code>apt update    
-apt-get install openjdk-11-jdk  +apt install openjdk-11-jdk  
-apt-get install unzip  +apt install unzip  
-apt-get install bc +apt install bc 
-apt-get install p7zip-full  +apt install p7zip-full  
 wget https://github.com/Qortal/qortal/releases/latest/download/qortal.zip wget https://github.com/Qortal/qortal/releases/latest/download/qortal.zip
-unzip qortal.zip +unzip qortal.zip  
-cd qortal   +cd qortal  
-wget https://qortal.tmgoxford.com/db.7z     +chmod +x *.sh  
-7za x db.7z  +./start.sh </code>
-chmod 0777 start.sh  +
-sh ./start.sh </code>+
 ===== Linux VPS Only Install ===== ===== Linux VPS Only Install =====
  
 **From Jaymen:** **From Jaymen:**
 <code>sudo -i                            <code>sudo -i                           
-apt-get update                    +apt update                    
 cd /home                           cd /home                          
 adduser test                       adduser test                      
 usermod -a -G sudo test           usermod -a -G sudo test          
-apt-get install openjdk-11-jdk    +apt install openjdk-11-jdk    
-apt-get install unzip              +apt install unzip              
-apt-get install bc                 +apt install bc                 
-apt-get install p7zip-full        +apt install p7zip-full        
 cd test                            cd test                           
 wget https://github.com/Qortal/qortal/releases/latest/download/qortal.zip wget https://github.com/Qortal/qortal/releases/latest/download/qortal.zip
 unzip qortal.zip             unzip qortal.zip            
-cd qortal +cd qortal                 
-wget https://qortal.tmgoxford.com/db.7z      +chmod +x *.sh               
-7za x db.7z                       +
-chmod 0777 start.sh               +
 chown -R test /home/test/qortal    chown -R test /home/test/qortal   
 su test                            su test                           
Line 238: Line 205:
 **From Jaymen:** **From Jaymen:**
 <code>wget https://github.com/Qortal/qortal/releases/latest/download/qortal.zip    <code>wget https://github.com/Qortal/qortal/releases/latest/download/qortal.zip   
-unzip qortal.zip                                                              +unzip qortal.zip                                                                                                        
-sudo apt-get install p7zip-full -y                                               +cd qortal                                                                                                                                             
-cd qortal                                                                                   +chmod +x *.sh                                                                        
-wget https://qortal.tmgoxford.com/db.7z                                                     +
-7z x db.7z                                                                                  +
-chmod 0777 start.sh                                                                        +
 echo -en "{\n\"apiDocumentationEnabled\": true\n}\n\"" > settings.json echo -en "{\n\"apiDocumentationEnabled\": true\n}\n\"" > settings.json
 ./start.sh </code>                                                                       ./start.sh </code>                                                                      
linux.txt · Last modified: 01/17/2024 21:07 by crowetic

Page Tools