Qortal Project

The future of blockchain platforms

User Tools

Site Tools


Sidebar

Qortal Project Wiki

Important Notices

Introduction

Project Model

Minting

Communications

Trade Portal

Data Hosting

Voting System

Hardware

Frequently Asked Questions (FAQ)

How-To Guides

Node Setup Guides

Third-Party Services

qortector_walkthrough

QORTector Walkthrough

Please note: this guide is for setting up your QORTector after it has been imaged. This video can be used for both those who purchased from https://crowetic.com or built on using the Raspberry Pi 4 help guide! The video below is a walkthrough guide of the SinclairMATE image.

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 G Factor:


PLEASE NOTE, IF YOU HAVEN'T DONE LOCALIZATION BEFORE CHANGING YOUR PASSWORD, PLEASE DO THAT FIRST, SCROLL DOWN ON THIS PAGE TO SEE GUIDE FOR LOCALIZATION. IF YOU DO NOT DO LOCALIZATION FIRST, YOU COULD LOCK YOURSELF OUT OF THE DEVICE.

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

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 Timezone setting has been successfully configured:

Change The Password

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

1. Type 'passwd' then press enter:

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

3. Enter your new password then 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':

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

5. 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.

Important Notes

1. Always tell QORTector to shut down the Qortal Core prior to turning off or rebooting the device to avoid corrupting the database:

sudo shutdown
reboot
 

Do not 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 consider 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. On the QORTector, you will not see the Qortal icon on the taskbar when you start the device.

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 USA - Pacific Standard Time locale by default.

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:

How To Update The Core and UI Versions

When your device arrives, you can let it sync and auto update the Core and UI if there was an update during shipment of your QORTector. You can also manually update the core and UI to expedite this process (which may be best or international orders that take longer to be delivered). Refer to the Qortal Status Updates page to check the latest Core and UI version.

To manually update the Core, open Terminal. Copy and paste this, then press the enter key:

cd && cd qortal && ./stop.sh && rm qortal.jar && rm -R db && curl -L -O https://github.com/Qortal/qortal/releases/latest/download/qortal.jar && ./start.sh

To manually update the UI, open Terminal. Copy and paste this, then press the enter key:

cd && cd Desktop && rm Start-Qortal* && wget https://github.com/Qortal/qortal-ui/releases/latest/download/Qortal-Setup-arm.AppImage && chmod +x Qortal-Set*.AppImage && mv Qortal-Set*.AppImage Qortal-UI

How To Change The Search Engine & Browser

The QORTector comes with Chromium web browser. For privacy-focused individuals, you may want to change it to Brave. Unfortunately Brave does not have a 32-bit option for the QORTector but we can change the settings on Chromium. Brave is actually built off Chromium for the record.

  1. Open Chromium
  2. Click the three dots in the top right corner of the Chromium window
  3. Click on 'Settings'
  4. On the left hand side, click on 'Search engine'.
  5. As you see, Brave is not an option already on Chromium, so click 'Add'.
  6. In the Search engine field, enter
    Brave
  7. In the Keyword field, enter:
    brave.com
  8. In the URL field, enter:
    https://search.brave.com/search?q=%s

    Then click 'Save'.

  9. Now click on the three dots next to the Brave search engine option and set as default.
  10. On the left hand side, click on 'Default browser'.
  11. Click on the dots next to startpage.com and click 'Remove'.
  12. Now click on 'Add a new page' and enter
    www.search.brave.com

    Then click 'Save'.

  13. That's it. You now have Brave set as the search engine and browser on Chromium!

Accessing Your QORTector Remotely

The QORTector can be connected to a monitor, keyboard, and mouse - making it a stand-alone desktop. It is also possible to access your QORTector from another computer. For example, you could avoid connecting the monitor, keyboard, and mouse and simply remote into the QORTector from your laptop. How To RDP page is a guide from a MacBook but should be the same process for any computer. For QORTectors with SinclairMATE (not Plumbus), you can use VNC instead of RDP which is already installed on the device.

Be sure to read the Remote Access Security Risks page as well!

Account Setup & Recovery

This is the most important thing to cover! Please be sure to setup your account correctly with backup files as only you can recover your account. The DevTeam is not able to assist you with recovering an account as Qortal is truly decentralized: Account Setup & Recovery

Port Forwarding

If you have admin access to your router, you should configure port forwarding for the QORTector. Refer to the Port Forwarding page on how to do so.

Adjusting json Settings For Low Bandwidth

For those who have low bandwidth internet service, you will want to reduce your peer settings in the json file. Simply change the minBlockchainPeers to 3, and the maxPeers to 16 as seen below (or just copy and paste the code below into your json file - replacing what is there currently):

{
"apiDocumentationEnabled": true,
"apiEnabled": true,
"apiRestricted": false,
"autoUpdateEnabled": true,
"minBlockchainPeers": 3,
"minOutboundPeers": 16,
"maxPeers": 16,
"listenPort": 12392,
"allowConnectionsWithOlderPeerVersions": false
}
qortector_walkthrough.txt · Last modified: 04/20/2022 20:54 by gfactor