Qortal Project

The future of blockchain platforms

User Tools

Site Tools


Sidebar

Qortal Project Wiki

Important Notices

Introduction

Project Model

Minting

Communications

Qortal Trading (Trade Portal / Q-Trade)

Qortal Data Network (QDN)

Voting System

AT (Automated Transactions)

Hardware

Frequently Asked Questions (FAQ)

How-To Guides

Node Setup Guides

Third-Party Services

ubuntu_22.04_with_cinnamon_desktop_setup

Ubuntu 24.04 Installation & Setup

Hello Qortians! This guide is for installation of Ubuntu 24.04 with automated configuration via crowetic's script to setup everything necessary for Qortal, and automate as much as possible.

Please note: IF YOU ARE GOING TO BE INSTALLING UBUNTU ON THE CURRENT COMPUTER YOU'RE USING, YOU WILL NEED TO SKIP THE BIOS CONFIGURATION UNTIL AFTER YOU HAVE DOWNLOADED THE UBUNTU 24.04 INSTALLATION MEDIA, AND BURNED IT TO A FLASH DRIVE. YOU WILL ALSO WANT TO BACKUP YOUR PERSONAL FILES, QORTAL WALLET BACKUP, DOCUMENTS, PICTURES, AND ANYTHING ELSE YOU NEED FROM YOUR COMPUTER TO ANOTHER HARD DRIVE. IDEALLY YOU WILL HAVE AN EXTERNAL HDD TO BACKUP FILES, AND A FLASH DRIVE FOR WRITING THE UBUNTU INSTALLATION MEDIA. WE DO NOT TAKE RESPONSIBILITY FOR ANYONE FOLLOWING THIS GUIDE AND NOT READING THOROUGHLY, AND LOSING PERSONAL DATA OR THEIR QORTAL BACKUP FILE. MAKE SURE YOU BACKUP THINGS FIRST!

This guide focuses on a clean base installation, with full system configuration handled automatically by the setup script.

Configuring The BIOS

Any good base-level setup guide includes starting at the lowest possible level. In our case, this means starting in the BIOS.

All BIOS are different, but the important points remain consistent:

Disabling Nonsense

Disable unnecessary features where possible: - Intel Management Engine - Computrace - TPM (optional depending on use case)

Disabling Secure Boot

(Optional)

Secure Boot is not required for Ubuntu. Disabling it avoids additional configuration complexity.

UEFI vs Legacy Boot

Prefer UEFI mode for: - Firmware update support - Modern compatibility

If available, enable CSM (Compatibility Support Module) for flexibility.

- Enable virtualization features - Enable HyperThreading / TurboBoost - Use adaptive battery settings (if applicable)

Installing Ubuntu 24.04

Download Ubuntu 24.04 Desktop ISO https://ubuntu.com/download/desktop

Creating Installation Media

Before installing Ubuntu, you must create a bootable USB flash drive.

You will need: - Ubuntu 24.04 ISO - USB flash drive (8GB+ recommended)

Download Ubuntu 24.04 Desktop ISO https://ubuntu.com/download/desktop

Windows

Use Rufus:

https://rufus.ie/en/

- Insert USB drive - Open Rufus - Select downloaded Ubuntu ISO - Use default settings (UEFI recommended) - Click Start

Linux

Use `dd` (WARNING: destructive if misused):

lsblk
sudo dd if=ubuntu-24.04-desktop-amd64.iso of=/dev/sdX bs=4M status=progress oflag=sync

Replace `/dev/sdX` with your USB device.

macOS

Booting from USB

- Insert USB into target machine - Reboot system - Enter boot menu (commonly F12, ESC, DEL) - Select USB device (UEFI mode preferred)

You will then see: Try or Install Ubuntu

Select Install Ubuntu to proceed.

Installation Notes

- Connect to network (LAN or WiFi) - Enable "Download updates during installation" - Use username qortal (recommended for automation compatibility)

Disk setup: - Choose Erase Disk and Install Ubuntu for a clean install

After installation: - Reboot and remove installation media - Ensure system boots correctly (adjust UEFI boot order if needed)

Installing Software & System Configuration

Congratulations! Ubuntu is now installed.

At this stage, DO NOT manually configure the desktop environment, themes, or applications.

All system setup is now handled automatically by the script below.

Crowe's 'rebuilt-machine.sh' Script

This script now performs full system provisioning, including:

- Desktop environment installation and configuration - Theme, layout, and UI customization - Qortal Core installation - Qortal Hub installation - Automation scripts (auto-fix, monitoring, cron setup) - Required dependencies and applications

Download and run the script:

cd && wget https://raw.githubusercontent.com/crowetic/QORTector-scripts/main/rebuilt-machine.sh && chmod +x rebuilt-machine.sh && ./rebuilt-machine.sh

Enter your user password when prompted.

The script will: - Install all required packages - Configure the entire desktop environment automatically - Install and configure Qortal Core + Hub - Set up automation and background services

Once complete, the system will reboot automatically.

Important Notes

- Manual desktop configuration is no longer required - Manual theme setup is no longer required - Manual launcher/menu configuration is no longer required

Everything is handled by the script for consistency and reliability.

Ubuntu Power Settings

To ensure Qortal runs continuously:

- Open Power Settings - Set Suspend when inactiveNever - Set Lid close actionDo Nothing - Set Power buttonAsk

Apply for both: - Plugged in - Battery (if applicable)

Qortal Startup Behavior

Startup configuration is handled automatically by the script.

No manual startup configuration is required.

Additional Notes

No manual configuration is required after running the setup script.

All automation, paths, and user-specific configuration are handled dynamically by the script.

Summary

This setup now prioritizes:

- Minimal manual configuration - Full automation via script - User-agnostic deployment (no required username) - Consistent, reproducible environments - Reliable Qortal node operation

ubuntu_22.04_with_cinnamon_desktop_setup.txt · Last modified: 04/11/2026 18:02 by crowetic