Qortal Project

The future of blockchain platforms

User Tools

Site Tools


Sidebar

Qortal Project Wiki

Qortal Project Model

Important Notices - MUST READ

QORT Minting

QORT Communications Plugin

QORT Trade Portal

Qortal Voting System

Qortal Data Hosting

Qortal Hardware

Frequently Asked Questions (FAQ)

QORT How-To Guides

qortector_walkthrough

QORTector Walkthrough

Please note: this guide is for setting up your QORTector purchased from Crowetic.com please go to Raspberry Pi 4 if you are building your own Raspberry Pi!

Setting Up Your QORTector:

Important: Do NOT run the QORTector if fan isn’t running after powering the device! The fan needs to be running to prevent the board from overheating.

Step by step direction are below. Here is a setup walkthrough video made by Crowetic:

https://youtu.be/Z6cERzvPGR0

1. Basically plug everything in (monitor, mouse, keyboard, power, HDMI, Ethernet), configure WiFi if you’re not using Ethernet, let it sync. Please note: Crowetic Hardware Development (CHD) is now selling QORTectors with optional power adapters with a USB-C cable seen in the picture below for easy reference of how to setup properly:

Login is username: Pi

Default password: dmax911e

2. Open MATE Terminal (often referred to as terminal). Below is a picture of the terminal icon you will see on the taskbar:

3. Type 'passwd' then press enter:

4. Enter the current password 'dmax911e' then press enter (you will not see the keys being entered, they are hidden):

5. Enter your new password 'abcd1234' the press enter (you will not see the keys being entered, they are hidden). You will then be asked to enter again. It will then say 'password updated successfully':

6. Open the Qortal UI which is already on your screen background titled 'Qortal-UI.sh'

7. Add your account with your backup file, or if you haven’t made an account yet, BE SURE TO SAVE A BACKUP FILE. See Account Setup & Recovery for more info.

Updating Qortal UI

The core auto-updates by default, but the UI does not auto-update at this time (coming soon). Please note: you probably have the latest version depending on timing. Be sure to double check what version you have in the UI after you login. Ask within the community to verify the latest UI version. If your device doesn’t have the latest UI version, open terminal and run this command (these devices comes with the script already for those wondering):

./update-qortal-ui.sh

You will be prompted to enter yes (Y) or no (N) several times (it also may not show a yes or no, but be sure to enter Y rather than just the enter key). You will type Y and press enter each time, let the process finish, it may take a while. It will say 'BUILD COMPLETE' when it has finished:

Setup QORTector Timezone

1. Open terminal and enter this below:

sudo raspi-config

2. Use the down arrow on your keyboard to highlight the fifth option for 'Localisation Options' and press enter:

3. Use the down arrow on your keyboard to highlight the second option for 'Timezone' and press enter:

4. Use the down arrow on your keyboard to highlight the country you are in and press enter:

5. Use the down arrow on your keyboard to highlight the city or region in your timezone and press enter:

6. Then press the right arrow key to highlight 'Finish' and press enter:

7. You will then see the Timzone setting has been successfully configured:

Important Notes

1. Always tell QORTector to shut down from the menu option, don’t use the power switch. Power switch should only be shut off after the device powers down to protect it from surges, but with that said, you should have a surge protector or UPS (battery power supply) regardless as the QORTector is intended to stay running 24/7.

2. The QORTector is setup to automatically start the Qortal Core in the background, this means you will not see the Qortal icon on the taskbar of the device, it runs in the background. When you restart the device, always remember to stop qortal first, as shown above.

The device was configured this way so that the Qortal core will start whether the user connects a monitor or not, you CAN configure it to start with a .desktop file so that it will show the icon on the taskbar, and there is a script for that available on crowetic's github. https://github.com/crowetic/qortector-scripts - there is a .desktop file there with instructions. You can also ask in the Qortal telegram or Discord for assistance.

3. The QORTector must be setup for your specific country locale for wifi and timezone, if you wish to use wireless communications. Follow the instructions above in order to configure the device for your locale. We will start configuring the devices for US locale by default, but the majority of them have been shipped with UK locale since company start.

4. If you have ANY issues whatsoever, please reach out in the Qortal Tech Support Official Telegram channel or Discord #qortector-pi-support channel!

Start & Stop QORTector

The QORTector is setup to automatically start the core when you turn on the device. You should always command the core to shut down within the Terminator (also referred to as the Terminal) prior to turning off the device to avoid corrupting the database. Make sure to cancel all trade within the Trade Portal before doing so.

To stop the core: open Terminator and enter the following separately:

 cd qortal
./stop.sh

It will then say 'Qortal ended gracefully' in green. You can then close the Terminator. Below is a screenshot of the entire process:

To start the core: open Terminator and enter the following separately:

 cd qortal
./start.sh

It will then say 'qortal running as pid xxxxx. You can then close the Terminator. Below is a screenshot of the entire process:

You will then see the Qortal Core startup indication:

To stop and start the core in one window: open Terminator and enter the following separately:

 cd qortal
./stop.sh
./start.sh

Below is a screenshot of the entire process:

You will then see the Qortal Core startup indication:

qortector_walkthrough.txt · Last modified: 2021/12/01 00:51 by gfactor