Qortal Project

The future of blockchain platforms

User Tools

Site Tools


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 [04/22/2022 14:31] croweticlinux [01/17/2024 21:07] (current) crowetic
Line 1: Line 1:
 ====== Linux (Debian+Ubuntu+Mint) ====== ====== 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, debian-based distros.)+**Please note:** after setting up your computer as a node, be sure to review the [[Port Forwarding]] guide to ensure your node functions optimally.  
 + 
 +=====New Method - Installing Qortal with the assistance of the Qortal UI ===== 
 + 
 +====Step 1- Download the Qortal UI AppImage from qortal.org ====  
 + 
 +====Step 2 - Make the AppImage Executable (either right click it, properties, permissions, allow executing as a program checkbox) ==== 
 + 
 +====Step 3 - Run the AppImage file ==== 
 + 
 +===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. === 
 + 
 +That's it, Qortal Core will start, bootstrap, and get synchronized, and you're good to go! 
 + 
 +===(additional optional visual improvments) === 
 + 
 +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)  
 + 
 +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|]] 
 + 
 +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! 
 + 
 + 
 + 
 +=====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.) (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.) (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.)
Line 12: Line 43:
 1. Install Java, and Unzip-  1. Install Java, and Unzip- 
  
-<code> sudo apt install default-jre </code>+<code> sudo apt install default-jre unzip</code>
    
-and install 'unzip' to extract archives in terminal:  
- 
-<code> sudo apt install 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): 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):
  
Line 24: Line 51:
 <code> wget https://github.com/Qortal/qortal/releases/latest/download/qortal.zip && unzip qortal.zip && cd qortal && chmod +x *.sh && ./start.sh </code> <code> wget https://github.com/Qortal/qortal/releases/latest/download/qortal.zip && unzip qortal.zip && cd qortal && chmod +x *.sh && ./start.sh </code>
  
-3. Download and install the Qortal UI debian installer - https://github.com/Qortal/qortal-ui/releases/latest/download/Qortal-Setup-amd64.deb - you can also download this with wget from terminal like this:+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> wget https://github.com/Qortal/qortal-ui/releases/latest/download/Qortal-Setup-amd64.deb && sudo dpkg -i Qortal-Setup-amd64.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>
  
-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.+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.
  
  
Line 36: Line 63:
  
 **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 75: Line 100:
 **Install Qortal core:** 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. 
- 
-We’re using "/qortal" as an example here. Substitute your path to where you want it. 
- 
-<code>md /qortal 
-cd /qortal 
-cp ~/Downloads/qortal.zip /qortal 
-unzip qortal.zip  
-chmod 744 *.sh</code> 
- 
-Using "p7zip" because none of the other utils work: 
- 
-<code>7za  x  ./db.7z</code> 
- 
-The perms on the files in the new ./db directory should be 644 and if they aren't set them: 
- 
-<code>ls -l /qortal/db 
-chmod 644 blockchain.data 
-chmod 644 blockchain.properties  
-chmod 644 blockchain.script</code> 
- 
-Edit the settings in the "settings.json" file: 
-     
-<code>{ 
-    "maxPeers":32, 
-    "minOutboundPeers":16, 
-    "minBlockchainPeers":8, 
-    "maxNetworkThreadPoolSize":25, 
-    "apiDocumentationEnabled":true 
-    }</code> 
  
 Now start the core: Now start the core:
Line 115: Line 108:
 It should tell you it's passed the java version check and give you the PID: It should tell you it's passed the java version check and give you the PID:
          
-    Passed Java version check +    "Passed Java version check 
-    qortal running as pid 2020+    qortal running as pid 2020"
  
 Make sure it is running: Make sure it is running:
Line 128: Line 121:
     2020     2020
          
-If you are running IPv4 only you will need this in your settings.json file: 
- 
-<code>"bindAddress":"0.0.0.0",</code> 
- 
-Omit the comma at the end if it is the last line before the closing brace } 
- 
 To stop it gracefully: To stop it gracefully:
  
Line 183: 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 
 chmod +x *.sh  chmod +x *.sh 
 ./start.sh </code> ./start.sh </code>
Line 196: Line 184:
 **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
linux.1650652311.txt.gz · Last modified: 04/22/2022 14:31 by crowetic