Qortal Project

The future of blockchain platforms

User Tools

Site Tools


Sidebar

Qortal Project Wiki

Important Notices

Introduction

Project Model

Minting

Communications

Trade Portal

Qortal Hosting (QDN)

Voting System

AT System

Hardware

Frequently Asked Questions (FAQ)

How-To Guides

Node Setup Guides

Third-Party Services

mac

Mac

Installing with the assistance of the Qortal UI

Step 1 - Download the Qortal UI .dmg from https://qortal.org

Step 2 - Double-click to mount the .dmg

Step 3 - Drag-n-Drop the Qortal UI application to Applications

Step 4 - Unmount the .dmg - on the desktop, right click the Qortal UI and unmount/eject

Step 5 - Launch the Qortal UI from Applications - search with spotlight search 'qortal' and launch Qortal UI application

Say YES to install java, this will install a portable version of Java

Say YES to download/install the Qortal Core

The Qortal Core will then start and bootstrap, you'll be setup in 5-15 minutes

Create account, login, and use Qortal!

Be sure to Disable sleep in power options, or the Qortal Core will stop when the computer goes to sleep

Old/Previous Method

Please note: after setting up your computer as a node, be sure to review the Port Forwarding guide to ensure your node functions optimally.

How to install Qortal on Mac: https://www.youtube.com/watch?v=6UPrQPKBlGA

THERE ARE TWO WAYS TO INSTALL JAVA. YOU CAN USE HOMEBREW OR INSTALL ADOPTIUM DIRECTLY. STEPS 1, 2, AND 3 ARE FOR THE HOMEBREW METHOD. BELOW THAT IS THE LINK TO ADOPTIUM WITH INSTRUCTIONS. SIMPLY DOWNLOAD THE PKG FOR YOUR VERSION OF MAC AND INSTALL IT.

1. Install adoptium using homebrew - open terminal and run the following command to install homebrew (triple-click the code window below and select/copy the entire command):

/bin/bash -c "$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/HEAD/install.sh)"

You will need to input your password into the terminal when this is going on (nothing will come up when you input your password, but just input and push return)

NOTE: The AdoptOpenJDK homebrew tap is depreciated as of 2021-08-01. It is recommended to uninstall that before continuing these instructions. more info

brew untap AdoptOpenJDK/openjdk

2. Once Homebrew is done and fully installed, install Java with this command:

brew install temurin --cask

YOU CAN SKIP ALL OF THE HOMEBREW STUFF BY INSTALLING JAVA WITH ADOPTIUM for Mac version 10.14 and later

Install Adoptium - simply click the link below then download the installer for your OS (pkg installer package) -https://adoptium.net/temurin/releases

3. When that is complete, you can verify your Java installation and version with one of these commands:

java --version

OR

java -version

4. Once you have java, download the qortal core zip with this command in Terminal (with return after command)(triple-click the code window below and select all then copy the entire line):

cd && curl -L -O https://github.com/Qortal/qortal/releases/latest/download/qortal.zip && unzip qortal.zip && cd qortal && chmod +x *.sh && ./start.sh

This will start Qortal Core, you will see a splash screen come up telling you it is downloading and extracting the bootstrap for you, let that finish, then it will run with a Q icon on the taskbar (the icon will be RED until it is fully synchronized, then it will be BLUE)

5. Download the Qortal UI dmg package - https://github.com/Qortal/qortal-ui/releases/latest/download/Qortal-Setup-macOS.dmg

6. Run (double click) Qortal-Setup-macOS.dmg and mount the image, it will come up with a little window and a drag n drop arrow with Qortal UI and Applications, drag Qortal UI to Applications.

7. Right click and 'unmount' or 'eject' the Qortal-Setup-macOS.dmg from finder.

8. Run Qortal UI (it will tell you that it can't run because of an unknown developer, click Open.

9. Use Qortal UI to create your account. Be sure you create a password you will remember, and save the backup file in multiple locations, this is the only way you can access your account from another computer. The account will save automatically on the computer it was created on, in the UI, for easy access next time. After you have created your account and your node is fully synchronized, if you would like to be a minter, let the group know, and someone will sponsor you.

For additional support go into the #mac-support channel in Discord or Tech Support in Telegram. See Community Run Services and Social Media pages

For new MAC versions Sierra and above, a helpful guide for allowing third-part apps to install: (Nov 8, 2021) https://it.nmu.edu/docs/allowing-third-party-applications-install-macbook

FYI: HELP GUIDES BELOW MAY SUGGEST BOOTSTRAPPING WHICH IS NO LONGER NEEDED AFTER CORE VERSION 2.0! These guides were made prior to 2.0

From Jomega513: Made a quick (15min) how to video for getting your core and ui installed and setup on your mac with step by step follow along directions. If this is helpful for anyone you can find it here (made on 11/11/21):

https://youtu.be/6UPrQPKBlGA

How to install JDK with Homebrew: https://youtu.be/ZTX8MOqDJkE

https://youtu.be/6NGb3e0mL1Y

https://youtu.be/lh0b_HBsNbk

From Scythian: How to install Qortal Core and Qortal UI on MAC OS (a beginners guide to setting up a Qortal node on MAC OS)

Video guide: https://youtu.be/E9bm_TOw6Bs

From kevaquarian: Hello Qortal troopers! I've had a few people ask about how to setup an Automator app for restarting the Core without the terminal. Here's a short vid that shows the steps - it's really simple. One thing - quit the Terminal app BEFORE running the created Automator app!

https://ln.sync.com/dl/4f24b0aa0/kzwhtrj7-s4ytyfzc-qtp26kue-2pfwvknq

From sakumatto: Guide for MAC from Derra: https://discord.com/channels/348175815822802946/810581978276823111/811306934883450881 If you need VNC for MAC: https://sourceforge.net/projects/cotvnc/

From ushemrog: Hi all, I updated the Beginners Guide for Mac Users, I shared yesterday. Now it is even easier to edit the settings.json file! Have a great one! P.S. You can also find this guide pinned in the Telegram Channel! qortal_mac_beginners_setup_guide_updated_by_helenar_11feb21.pdf

mac.txt · Last modified: 01/17/2024 21:13 by crowetic