It is a VERY exciting day for Qortal Project today… as we are officially ‘going public’ with the current setup of the Qortal Core, and Qortal UI.
Now, not everything is perfect, there are many little things I will discuss as this post continues.
Now, let’s begin!
First Step – Setup Qortal Core
The Qortal Core is already ‘released’ in a final version.
There are two ‘releases’ here on the github… https://github.com/QORT/qortal/releases
There is one exe (for windows users) – https://github.com/QORT/qortal/releases/download/v1.0.1/Qortal-1.0.1.exe
and one zip (for everyone else) – https://github.com/QORT/qortal/releases/download/v1.0.1/qortal-1.0.1.zip
All you have to do is either run the installation utility (windows) or extract the zip and run ‘run.sh’ (linux)
download and run the exe link above. When done, you will end up with a Qortal program. Simply run that program.
This will start your Qortal Core (also known as ‘blockchain node, peer, full-node, etc’) and start sync’ing the chain.
For Linux users, download the zip above, and run the ‘run.bat’ file. (I might suggest commenting out the XMX and XMS Java memory args portion)
if you are running a desktop version of Linux, you will have a popup that comes up, then in systray the Qortal icon. It will then start sync’ing the blockchain.
THE CORE MUST RUN ON THE SAME MACHINE AS THE UI FOR NOW. THE CORE MUST RUN BEFORE YOUR UI WILL FUNCTION FULLY
Current chain – until tomorrow
The current chain is the development pre-chain. It is at block 37837. This chain will be reset via an auto-update TOMORROW.
If you are someone who is supposed to have a pre-enabled minting account… you will not be able to issue the commands to start minting, until AFTER the chain reset tomorrow. That is when your account will be minting-enabled.
Next – setup Qortal UI (from source during pre-launch)
The Qortal UI at this point, does not have a ‘release’ on github yet. We are working that out… so, until it is worked out… we are giving people scripts to help them build the UI from source.
These scripts will do all the necessary dependencies, git repos, etc… build and run the UI sever (Written in node.js).
When we are done with this phase, both the core and the UI will have release packages, and both will auto-update. However, for now, that is not the case yet, and so we are making the build process as simple as possible for everyone.
There will be other scripts to check for updates, etc… that can be put into cron or startup, so that your system always remains updated… whether you decide to use the release package when available, or not. You can keep using the source version if you like.
Linux – The linux UI Install Script
The linux UI install script has only been tested so far on ubuntu machines. So bear that in mind if you’re on another version. The script is very easy to read, and the commands will stay very similar if you’re running another version of Linux, so you can most likely figure it out. If not, contact us in Discord for help.
right click the link and click ‘save as’ then save as qort-ui-install.sh
- Download the script from – https://github.com/crowetic/qort-ui-install.sh/raw/master/qort-ui-install.sh
- Place the script into the folder you want the Qortal UI to be setup.
- chmod +x qort-ui-install.sh
- ./qort-ui-install.sh -i
The script will download and setup all dependencies, the dependency repos, all git repos for the UI, and do the entire link and build process for you.
The script will then launch the UI.
You can then access the UI via localhost – http://localhost
To launch the UI after the initial install, simply open a terminal to the ‘qortal-ui’ folder, and run ‘yarn run server‘.
Windows – The Windows UI Install Script
The Windows UI install script has only been tested on a couple machines, but has worked correctly. Again, please note, the method described here is only for the time prior to the UI having a full release pre-built package. We are providing these scripts to be able to give out the software prior to that point.
NOTE – DO NOT MESS WITH THE WINDOWS THAT COME UP ONCE THE SCRIPT HAS STARTED, YOU MAY CAUSE ISSUES! JUST LET IT RUN THROUGH.
right click ‘save as‘ then save as ‘qort-ui-install.bat‘ and ‘start-UI.bat‘
- Download the script from – https://github.com/crowetic/qort-ui-install.bat/raw/master/qort-ui-install.bat
- put the script into the folder you want the UI repos to be setup in.
- right click the script and click ‘run as admin‘
- let it run and do not interfere with the windows that come up.
- access the UI (make sure you have your core running first, search ‘qortal’ and run the qortal app first) then access with – http://localhost
- To re-run the server after initial install, right click ‘save as’ on this – https://github.com/crowetic/qort-ui-install.bat/raw/master/start%20UI.bat
- then simply run the ‘start UI.bat’ (make sure the scripts are saved in the MAIN folder, not in any of the qortal-ui repo folders.)
be sure you have both scripts in the MAIN folder, where all the qortal-ui folders are, NOT inside any of the folders.
A few Notes
The current UI is not a release package, and our scripts help build from source. You can continue to do this, and will have other scripts available for updating, etc…
Once the release packages ARE available for the UI, the UI will auto-update just like the core.
The core, will NEVER NEED TO BE UPDATED AGAIN, as it is AUTO-UPDATED. Even after the pre-chain restart, it will update itself.
Think of Qortal Project software-wise, as TWO PARTS.
Each of them are independent servers.
Core – written in java, has full release version, contains the blockchain, sync, etc.
There are many things that are NOT FULLY COMPLETE in the UI, such as previous QORA balance, minting status, etc… anything that ‘looks odd’ or ‘isn’t updating’ simply isn’t fully implemented yet.
The minting transaction creation, and assigning a minting key to a node, all function, but we will post another blog post about that tomorrow, with explanation on what to do if you have a pre-enabled minting account.
Sponsoring a minter is possible as well, and either the sponsor, or the minter being sponsored, can run their node during the sponsorship period. We will explain how this is done in another blog post as well.
THIS VERSION IS THE VERY FIRST RELEASE, AND ISN’T EVEN A FINAL RELEASE OF THE UI, IT IS PUT OUT SO PEOPLE CAN START GETTING USED TO THE CONCEPTS, AND SINCE IT IS MORE A DEVELOPMENT VERSION ANYWAY, IT GIVES A SLIGHTLY GREATER UNDERSTANDING OF WHAT IS GOING ON IN THE BACK END. WE BELIEVE IT IS GOOD FOR PEOPLE TO HAVE A GREATER UNDERSTANDING, UNTIL WE MAKE THE UI SO EASY ANYONE CAN SIMPLY USE IT WITHOUT ANY UNDERSTANDING NEEDED.
Any questions, issues, concerns, please reach out in Discord. Thank you!
Qortal Current Development Team
crowetic – Team Lead