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.
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:
Disable unnecessary features where possible: - Intel Management Engine - Computrace - TPM (optional depending on use case)
(Optional)
Secure Boot is not required for Ubuntu. Disabling it avoids additional configuration complexity.
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)
Download Ubuntu 24.04 Desktop ISO https://ubuntu.com/download/desktop
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
Use Rufus:
- Insert USB drive - Open Rufus - Select downloaded Ubuntu ISO - Use default settings (UEFI recommended) - Click Start
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.
Use `dd` or:
- 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.
- 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)
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.
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.
- 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.
To ensure Qortal runs continuously:
- Open Power Settings - Set Suspend when inactive → Never - Set Lid close action → Do Nothing - Set Power button → Ask
Apply for both: - Plugged in - Battery (if applicable)
Startup configuration is handled automatically by the script.
No manual startup configuration is required.
No manual configuration is required after running the setup script.
All automation, paths, and user-specific configuration are handled dynamically by the script.
This setup now prioritizes:
- Minimal manual configuration - Full automation via script - User-agnostic deployment (no required username) - Consistent, reproducible environments - Reliable Qortal node operation